Federal spending
US federal award recipients and obligation aggregates from USAspending — recipient registry, fiscal-year obligation trends, and top awarding agencies.
Paths are relative to https://api.agentdatasets.com. Every endpoint mirrors an MCP tool over the same service layer — the tool catalog documents the same operations for MCP clients.
GET/v1/gov/recipients/awards
Recipient Awards
Parameters
| Name | Type | Required | Default | Constraints | Description |
|---|---|---|---|---|---|
| recipient | string | Yes | — | — | Exact recipient_id, UEI, or unique canonical recipient name |
| fiscal_years | integer | No | 5 | min 1, max 20 | Fiscal-year rows to return, newest first |
| cursor | string | null | No | — | — | Opaque pagination.next_cursor from the prior response |
Example request
Required parameters only, with values taken from the schema. Optional parameters are in the table above.
[ BASH ]
curl --fail --silent --show-error \
--header "X-API-KEY: adk_..." \
"https://api.agentdatasets.com/v1/gov/recipients/awards?recipient=RECIPIENT"Response
200 Successful Response · expand a branch to see its fields.
dataRecipientAwardsDatarequired
- recipient_idstringrequired
- namestringrequired
- ueistringrequirednullable
- dunsstringrequirednullable
- recipient_levelstringrequired
- parent_ueistringrequirednullable
- parent_namestringrequirednullable
- units"USD"default "USD"
- currency"USD"default "USD"
- period_type"fiscal_year"default "fiscal_year"
- amount_basis"transaction-level obligations"default "transaction-level obligations"
- source_notesstringdefault "USAspending API transaction-level obligations, the same basis used by recipient profiles."
fiscal_yearsarray<RecipientFiscalYearAward>required
- fiscal_yearintegerrequired
- total_obligationsstringrequiredpattern ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
- contract_obligationsstringrequiredpattern ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
- direct_obligationsstringrequiredpattern ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
- grant_obligationsstringrequiredpattern ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
- idv_obligationsstringrequiredpattern ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
- loan_obligationsstringrequiredpattern ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
- other_obligationsstringrequiredpattern ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
top_agenciesarray<TopAgency>required
- namestringrequired
- codestringrequirednullable
- amountstringrequiredpattern ^(?!^[-+.]*$)[+-]?0*\d*\.?\d*$
- as_ofstring (date-time)required
metaMetarequiredResult-level provenance. ``source`` is a stable connector identifier (e.g. ``sec_edgar_companyfacts``); ``as_of`` is the freshest value-level ``as_of`` on the returned page, or ``None`` when the page is empty. Event-grained sources carry an aware datetime; date-grained sources (e.g. an SEC filing's report period) carry a plain date.
- sourcestringrequired
- as_ofstring (date-time) | string (date)nullable
paginationPaginationnullable
- limitintegerrequired
- has_morebooleanrequired
- next_cursorstringnullable
GET/v1/gov/recipients/search
Recipients Search
Parameters
| Name | Type | Required | Default | Constraints | Description |
|---|---|---|---|---|---|
| query | string | Yes | — | — | Recipient name, USAspending recipient_id, or UEI |
| limit | integer | No | 10 | min 1, max 50 | Maximum ranked recipient matches |
Example request
Required parameters only, with values taken from the schema. Optional parameters are in the table above.
[ BASH ]
curl --fail --silent --show-error \
--header "X-API-KEY: adk_..." \
"https://api.agentdatasets.com/v1/gov/recipients/search?query=QUERY"Response
200 Successful Response · expand a branch to see its fields.
dataRecipientSearchDatarequired
- querystringrequired
matchesarray<RecipientMatch>required
- recipient_idstringrequired
- namestringrequired
- ueistringrequirednullable
- dunsstringrequirednullable
- recipient_levelstringrequired
- parent_ueistringrequirednullable
- parent_namestringrequirednullable
- scoreintegerrequired
- match_reasonstringrequired
- as_ofstring (date-time)required
metaMetarequiredResult-level provenance. ``source`` is a stable connector identifier (e.g. ``sec_edgar_companyfacts``); ``as_of`` is the freshest value-level ``as_of`` on the returned page, or ``None`` when the page is empty. Event-grained sources carry an aware datetime; date-grained sources (e.g. an SEC filing's report period) carry a plain date.
- sourcestringrequired
- as_ofstring (date-time) | string (date)nullable
paginationPaginationnullable
- limitintegerrequired
- has_morebooleanrequired
- next_cursorstringnullable