get_agency_awards
Get one obligation total and transaction count for an agency's awards in a fiscal year.
The total covers ALL award types together (contracts, IDVs, grants,
loans, direct payments, other), so for most civilian agencies it is far
larger than contract spending (VA FY2026: $313B here vs $84B contracts).
For the split by award type use get_agency_obligations_by_award_category().
toptier_code is auto-padded to 3 digits if a shorter numeric value is
supplied.
fiscal_year defaults to the last completed fiscal year, not the current
one (USAspending's own default, which right after October 1 holds only a
few days of data). The answer always carries fiscal_year.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"toptier_code": "<toptier_code>"
},
"name": "get_agency_awards"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| fiscal_year | No | ||
| toptier_code | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||