List cost item versions
List the time-versioned rates visible to the caller.
This resource carries monetary values and is permissioned separately from the cost items themselves, so a caller who can see the register may still not be able to see its rates.
Filter by cost_item for a single rate code’s history, and by in_force_on
for the rate that applied on a particular date.
Authorizations
Session token for authentication.
Query Parameters
A comma separated list of related resources to include.
organisation, cost_item Filters the response data based on the value provided.
Available filters:
id_in: Filter by cost item version ID(s)cost_item: Filter by the cost item the version belongs toversion: Filter by version numbereffective_from,effective_to: Filter on the effective window boundsin_force_on: Return only the version that applied on a given date, for exampleeq(in_force_on,2026-03-14). Combine withcost_itemto resolve the rate that applied to a job on the day the work was carried out.
For more information on using named filters, see the docs
A comma separated list of fields to sort by. version is the register's own
sequence for a cost item, so sorting by it gives the rate history in order.
version, -version, effective_from, -effective_from, effective_to, -effective_to, created_at, -created_at Limit the number of resources returned by the API
x >= 1Offset the resources returned by the API
x >= 0