Skip to navigation
API ReferenceBudgets and FundingList costs records

List costs records

Published costs collection. Existing generic route with a concrete dataset name. Requires data:read. Stable-key identity; ordered by id. Text search is unavailable; omit q.

Authentication

AuthorizationBearer

Create a scoped key at https://app.defdex.io/developer/keys. Keep it private.

Query parameters

limitintegerOptional1-100Defaults to 25
Maximum records per page.
cursorstringOptional<=12000 characters

Opaque next_cursor from the preceding page. Keep dataset, q and filters unchanged.

filtersstringOptional

URL-encoded JSON object; exact equality on up to 12 published fields, AND-combined. Primitive or null values only; strings at most 500 characters. No range, array-containment, OR or sort operators. Allowed fields: id, program_id, system_id, kind, fiscal_year, appropriation, budget_line, unit_cost_basis, quantity, amount, currency, amount_usd, dollar_basis, base_year, country, observation_date, notes, confidence, as_of.

Response headers

X-Request-IdstringOptional
Support identifier on admitted requests.

Response

Success
datalist of objects
next_cursorstring or null
build_idstring

Publication observed for this response; compare across related reads.

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
409
Conflict Error
429
Too Many Requests Error
503
Service Unavailable Error