# List budget accounts

Get a list of all budget accounts in your project, organized from top to bottom.

Returns every account that appears as its own section in your budget. Each account 
is a budget category (like "Camera Department" or "Post-Production") that contains 
its own line items and subtotals.

Perfect for:
- Building dropdown menus to select accounts
- Showing where you are in the budget (like breadcrumbs: Production > Camera > Equipment)
- Getting all account names and codes without loading the entire budget
- Understanding your budget's organization

The accounts come back in a natural reading order—parent accounts first, then their 
children. For example: [/1000 Production, /1000/1100 Camera, /1000/1200 Sound, /2000 Post]

Each account includes a path showing its location in your budget structure. For instance, 
"/2000/2100" means account 2100 sits inside account 2000.

Endpoint: GET /projects/{projectId}/budget/accounts
Version: 1.0.0
Security: ApiKeyAuth

## Path parameters:

  - `projectId` (string, required)
    Project identifier (alias or ID)
    Example: "nike-spring-2024"

## Response 200 fields (application/json):

  - `accounts` (array)

  - `accounts.id` (string, required)
    Account system identifier
    Example: "acc-xyz-789"

  - `accounts.accountId` (string,null, required)
    User-friendly account code/number
    Example: "2150"

  - `accounts.path` (string, required)
    Hierarchical path in budget tree
    Example: "/2000/2150"

  - `accounts.description` (string,null, required)
    Account description
    Example: "Camera Equipment"

## Response 401 fields (application/json):

  - `error` (string, required)
    Error message
    Example: "Invalid request parameters"

  - `details` (object)
    Additional error details
    Example: {"field":"projectId","reason":"Project not found"}

  - `code` (string)
    Error code
    Example: "VALIDATION_ERROR"

## Response 404 fields (application/json):

  - `error` (string, required)
    Error message
    Example: "Invalid request parameters"

  - `details` (object)
    Additional error details
    Example: {"field":"projectId","reason":"Project not found"}

  - `code` (string)
    Error code
    Example: "VALIDATION_ERROR"

## Response 500 fields (application/json):

  - `error` (string, required)
    Error message
    Example: "Invalid request parameters"

  - `details` (object)
    Additional error details
    Example: {"field":"projectId","reason":"Project not found"}

  - `code` (string)
    Error code
    Example: "VALIDATION_ERROR"