# Get an average budget information

**GET /users/{id_or_external_id}/budget**

Fetch information of an user's budget, spending distribution, including average monthly budget over the past 12 months, essential and non-essential expenditure, top-3 spending categories.



## Servers
- Base production URL: https://link.goscore.me/finid-api/1.0 (Base production URL)



## Parameters

### Path parameters
- **id_or_external_id** (string)
  UUID or external ID of a user profile to get access to their reports and data.



## Responses
### 200
User budget retrieved

#### Body:  (object)
- **budget_distribution** (array[object])
  Average budget items distribution (in %)
- **budget_items** (array[object])
  Average budget over the past 12 months
- **expenditures** (object)


### 404
User not found

### 500
The request is not valid.

#### Body:  (object)
- **error_message** (string)
  Human readable error message.
- **error** (string)
  Error code & short status


[Powered by Bump.sh](https://bump.sh)