> ## Documentation Index
> Fetch the complete documentation index at: https://docs.equalsmoney.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List all budgets

> When your account is created, we automatically create a parent budget (`accountBalance`) for you. There is only ever one parent budget on an account, 

# Step 2: list all budgets

When your account is created, we automatically create a parent budget (`accountBalance`) for you. There is only ever one parent budget on an account, but you can have as many sub-budgets (and sub-sub-budgets) as you'd like.

Let's get a list of your budgets, so that we can retrieve the ID of the parent budget.

<CodeGroup>
  ```bash Sandbox theme={null}
  curl -i -X GET 'https://api-sandbox.equalsmoney.com/v2/budgets?accountId={accountId}' \ # Your account ID
  -H 'Authorization: ApiKey {apiKey}' \ # Your API key
  -H 'Content-Type: application/json'
  ```

  ```bash Production theme={null}
  curl -i -X GET 'https://api.equalsmoney.com/v2/budgets?accountId={accountId}' \ # Your account ID
  -H 'Authorization: ApiKey {apiKey}' \ # Your API key
  -H 'Content-Type: application/json'
  ```
</CodeGroup>

If your request is successful, you'll receive a `200` response containing a list of all the budgets on your account. Look for the budget with the `accountBalance` type and make note of its `id`. In this example, the account is new so there is only one budget.

```json theme={null}
{
  "count": 1,
  "limit": 100,
  "offset": 0,
  "rows": [
    {
      "id": "6e08e7f7-f906-469e-b061-3dcb6def9b20",
      "accountId": "F12345",
      "parentId": null,
      "boxId": "19581e27de",
      "name": "Account balance",
      "type": "accountBalance",
      "status": "active",
      "allowCurrencyAlignment": false,
      "createdAt": "2023-08-29T15:15:04.000Z",
      "updatedAt": "2023-08-29T15:15:04.000Z",
      "feature": [
        {
          "id": "4cf0102e-cf6b-4980-a60f-a3e6e1fdf617",
          "budgetId": "6e08e7f7-f906-469e-b061-3dcb6def9b20",
          "payments": true,
          "budgetCards": false,
          "peopleCards": false,
          "forwardDeposits": false,
          "createdAt": "2023-08-29T15:15:04.000Z",
          "updatedAt": "2023-08-29T15:15:12.000Z",
          "BudgetId": "6e08e7f7-f906-469e-b061-3dcb6def9b20"
        }
      ],
      "currency": [
        {
          "createdAt": "2023-08-29T15:15:04Z",
          "updatedAt": "2023-08-29T15:15:04Z",
          "id": "fc6c42b9-ea54-4dfc-ad98-39894ec1b95b",
          "budgetId": "6e08e7f7-f906-469e-b061-3dcb6def9b20",
          "boxCurrencyId": null,
          "currencyCode": "GBP",
          "local": "unique",
          "international": "unique", 
          "BudgetId": "6e08e7f7-f906-469e-b061-3dcb6def9b20"
        }
      ],
      "balance": []
    }
  ]
}
```

### What if it goes wrong?

If your `accountId` is incorrect or missing, you'll receive an error like this:

```json 400 theme={null}
{
  "path": "/v2/budgets",
  "message": "request/query must have required property 'accountId'"
}
```