# List budgets

Retrieve a paginated list of budgets with filtering and search capabilities.

Endpoint: GET /public/v1/budgets/
Version: 1.0.0

## Query parameters:

  - `search` (string,null)

  - `budget_type` (array,null)
    Enum: "income_statement", "balance_sheet"

  - `calendar_year` (array,null)

  - `company_id` (array,null)

  - `record_status` (array,null)
    Enum: "draft", "posted", "archived"

  - `limit` (integer)
    Number of records to return per page (capped at 100)

  - `offset` (integer)
    Number of records to skip before starting to return results

## Response 200 fields (application/json):

  - `items` (array, required)

  - `items.id` (integer, required)

  - `items.name` (string, required)

  - `items.company_id` (integer,null, required)

  - `items.company_name` (string, required)

  - `items.budget_type` (string, required)
    Enum: "income_statement", "balance_sheet"

  - `items.calendar_year` (integer, required)

  - `items.start_date` (string, required)

  - `items.end_date` (string, required)

  - `items.record_status` (string, required)
    Enum: "draft", "posted", "archived"

  - `items.actuals_offset_in_months` (integer,null)

  - `items.classifications` (array)

  - `items.classifications.line_id` (integer, required)

  - `items.classifications.line_name` (string, required)

  - `items.updated_at` (string, required)

  - `count` (integer, required)

## Response 400 fields (application/json):

  - `success` (boolean)

  - `errors` (object, required)

## Response 500 fields (application/json):

  - `success` (boolean)

  - `errors` (object, required)