gov_get_recipient_awards
Fetch one recipient's bounded fiscal-year USAspending obligations.
Description
Fetch one recipient's bounded fiscal-year USAspending obligations.
Returns newest-first fiscal-year totals, six USAspending award-type
obligation splits, and the top 10 awarding agencies. Amounts are exact
USD transaction-level obligations, the same basis used by USAspending
recipient profile pages; meta.source is usaspending and as_of is
the freshest row on the page. The default is 5 fiscal years and the
maximum is 20. Follow pagination.next_cursor until has_more is false.
Results are for the recipient as registered with USAspending (child/recipient level); figures are NOT parent-company rollups; parent linkage fields indicate where a parent exists.
Unknown or ambiguous recipients are unknown_entity with possible
suggestions; an invalid cursor is bad_parameter. A known recipient
with no award rows returns an empty successful page.
Example: gov_get_recipient_awards(recipient="UEI123456789", fiscal_years=5).
Parameters
Input schema advertised to MCP clients and mirrored by the REST query string.
| Name | Type | Required | Default | Constraints | Description |
|---|---|---|---|---|---|
| recipient | string | Yes | — | — | Exact USAspending recipient_id, 12-character UEI, or case-insensitive unique canonical name; use gov_search_recipients to resolve ambiguity. |
| fiscal_years | integer | No | 5 | min 1, max 20 | Federal fiscal-year rows to return newest first (1–20). |
| cursor | string | null | No | null | — | Opaque pagination.next_cursor from the previous response; keep recipient constant while paging. Omit for the newest fiscal year. |
Provenance
Sources behind every value this tool returns.
- usaspendingU.S. Department of the Treasury, USAspending.gov
Dataset registry: gov_recipient_awards