Finance > BudgetOption

Reads all Budget options

Changed on

Fetch budget options for the company

get/api/2026-10-01/resources/finance/budget_options

Request

  • Base URL
    https://api.factorialhr.com
  • URL
    https://api.factorialhr.com/api/2026-10-01/resources/finance/budget_options
  • Auth
    • OAuth 2
      Authorization code: https://id.factorialhr.com/oauth/authorize
      Token URL: https://id.factorialhr.com/api/oauth/token scopes: finance
    • or API key in header x-api-key

Query parameters

ids[]string[]

Search budget options by ID

[
  "1"
]
employee_ids[]string[]

Search budget options by employee IDs

[
  "1"
]
effective_atstring

Filter budget options effective at this date

Example:2021-01-01T00:00:00Z
include_inactiveboolean required

Include inactive budget options

include_archivedboolean required

Include archived budget options

Response

OK

Example response

{
  "data": [
    {
      "id": "1",
      "name": "Marketing Budget",
      "description": "Budget for marketing activities",
      "currency": "EUR",
      "legal_entity_id": "11"
    }
  ]
}

Changes