# List accounts

`GET /v1/accounts`

Returns the company's whole chart of accounts, not paginated. Headings and subtotals are included; only `profitAndLoss` and `status` accounts can be posted to.

**Scopes:** any of `setup:read`, `read:ledger`

## Request

```bash
curl https://api.numina.app/v1/accounts \
  -H "Authorization: Bearer numi_YOUR_API_KEY"
```

## Response `200`

List of accounts

```json
{
  "accounts": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "account_number": 3000,
      "name": "Revenue",
      "description": "Revenue from sales",
      "account_type": "profitAndLoss",
      "default_vat_code": "U25"
    }
  ]
}
```

## Errors

- `401` Unauthorized - Invalid or missing authentication
- `403` Forbidden - Missing scope, or the company is archived
- `429` Too Many Requests - Rate limit exceeded
- `500` Internal Server Error

See https://developers.numina.app/errors.md for the error format.