HUhubstaff
budgets

List organization budget histories

Returns budget configuration history (changes to budget settings over time) for the given organization.

The project_ids and client_ids filters are processed as a complete set.

  • If project_ids 1,2,3 and client_ids 4,5,6 are provided then all budget histories for those project and clients will be returned.
  • If only project_ids 1,2,3 (no client_ids filter) are provided then only budget histories for those projects will be returned (no client budgets at all).
  • If only client_ids 1,2,3 (no project_ids filter) are provided then only budget histories for those clients will be returned (no project budgets at all).

Further resource may be specified to restrict only returning budget histories for either projects or clients. The resource filter is combined with the project_ids/client_ids filters thus

  • If only project_ids is provided and resource = 'client' then no records will be returned

The start_date filters only apply to the starting date of the start_date of the budget history records. Thus to fetch only budget histories for this month for all projects specify this filter

  • resource=project and start_date[start]=2026-11-01
get/v2/organizations/{organization_id}/budget_histories

Request

Path parameters

organization_idinteger required

Query parameters

page_start_idinteger

The page start ID.

page_limitinteger

The default page size

project_idsinteger[]

List of project IDs

client_idsinteger[]

List of client IDs

resource'project' | 'client'

Only return budgets for this resource type

start_date[start]string date

Include budget histories with a start date on or after this date (ISO 8601)

start_date[stop]string date

Include budget histories with a start date on or before this date (ISO 8601)

includestring[]

Specify related data to side load.

Response

A list of budget histories

Changes

No recorded changes to this operation across all 1 revision of this API.