USAspending API
API for accessing U.S. federal spending data including contracts, grants, loans, and other financial assistance awards. Provides detailed information on agencies, recipients, budgetary resources, and award transactions. Data is sourced from federal agencies and published under the DATA Act transparency mandates.
Base URL:
Auth: unknown
Endpoints: 77
Reachable: yes
CORS: unknown
Last checked: 2026-03-14 22:15:18.075091
https://api.usaspending.gov/Auth: unknown
Endpoints: 77
Reachable: yes
CORS: unknown
Last checked: 2026-03-14 22:15:18.075091
Links
SDKs:
- usaspending-api-go (go)
- USASpending ORM (python)
- usa-spent async client (python)
- usaspending ruby gem (ruby)
- usaspending-rb Ruby client (ruby)
970ms
Avg latency (7d)68
Probes (7d)Latency (7d)
Success Rate (7d)
Topics
Endpoints
| Method | Path | Summary | Auth | Last Status | Latency |
|---|---|---|---|---|---|
GET |
/agency/{toptier_agency_code}/ | Get agency overview | — | — | — |
GET |
/agency/{toptier_agency_code}/awards/ | Get agency awards summary | — | — | — |
GET |
/agency/{toptier_agency_code}/budgetary_resources/ | Get agency budgetary resources | — | — | — |
GET |
/agency/{toptier_agency_code}/federal_account/ | Get agency federal accounts | — | — | — |
GET |
/agency/{toptier_agency_code}/object_class/ | Get agency object classes | — | — | — |
GET |
/agency/{toptier_agency_code}/program_activity/ | Get agency program activities | — | — | — |
GET |
/agency/{toptier_agency_code}/sub_agency/ | Get agency sub-agencies | — | — | — |
GET |
/agency/{toptier_code}/ | Get agency overview | none | — | — |
GET |
/api/v2/agency/{toptier_agency_code}/ | Get agency overview | none | 200 | 910ms |
GET |
/api/v2/agency/{toptier_agency_code}/awards/ | Get agency awards | none | 200 | 935ms |
GET |
/api/v2/agency/{toptier_code}/ | Get agency overview | none | 200 | 759ms |
GET |
/api/v2/agency/{toptier_code}/awards/ | Get agency awards summary | none | — | — |
GET |
/api/v2/agency/{toptier_code}/budgetary_resources/ | Get budgetary resources | none | 200 | 754ms |
GET |
/api/v2/agency/{toptier_code}/obligations_by_award_category/ | Get Obligations by Award Category | none | 200 | 998ms |
GET |
/api/v2/agency/{toptier_code}/sub_agency/ | Get sub-agencies | none | — | — |
GET |
/api/v2/awards/last_updated/ | Get last updated date | none | 200 | 757ms |
GET |
/api/v2/awards/{award_id}/ | Get award details | none | 200 | 808ms |
GET |
/api/v2/budget_functions/list_budget_functions/ | List budget functions | none | — | — |
GET |
/api/v2/disaster/overview/ | Get disaster funding overview | none | — | — |
GET |
/api/v2/federal_accounts/{account_code}/ | Get federal account | none | 200 | 1288ms |
GET |
/api/v2/financial_balances/agencies/ | Get financial balances by agency | none | 400 | 749ms |
GET |
/api/v2/recipient/duns/ | List recipients | none | 405 | 763ms |
GET |
/api/v2/recipient/state/ | Get all states info | none | 200 | 761ms |
GET |
/api/v2/recipient/state/{fips}/ | Get state info | none | 200 | 964ms |
GET |
/api/v2/recipient/{duns_or_uei}/ | Get recipient overview | none | 400 | 761ms |
GET |
/api/v2/recipient/{recipient_id}/ | Get Recipient Details | none | 400 | 761ms |
GET |
/api/v2/references/agency/{agency_id}/ | Get agency reference | none | 200 | 827ms |
GET |
/api/v2/references/assistance_listing/ | Get assistance listings (CFDA) | none | 200 | 773ms |
GET |
/api/v2/references/award_types/ | Get award types | none | 200 | 763ms |
GET |
/api/v2/references/cfda/totals/{cfda}/ | Get CFDA totals | none | 204 | 1246ms |
GET |
/api/v2/references/data_dictionary/ | Get data dictionary | none | 200 | 897ms |
GET |
/api/v2/references/def_codes/ | Get DEF codes | none | 200 | 763ms |
GET |
/api/v2/references/glossary/ | Get glossary | none | 200 | 812ms |
GET |
/api/v2/references/naics/ | Get NAICS Codes | none | 200 | 756ms |
GET |
/api/v2/references/naics/{naics_code}/ | Get NAICS code | none | 200 | 779ms |
GET |
/api/v2/references/submission_periods/ | Get submission periods | none | 200 | 766ms |
GET |
/api/v2/references/toptier_agencies/ | Get toptier agencies | none | 200 | 812ms |
GET |
/api/v2/references/total_budgetary_resources/ | Get total budgetary resources | none | 200 | 1320ms |
GET |
/award_spending/recipient/ | Get award spending by recipient | — | — | — |
GET |
/awards/count/federal_account/{award_id}/ | Count award federal accounts | — | — | — |
GET |
/awards/count/subaward/{award_id}/ | Count award subawards | — | — | — |
GET |
/awards/count/transaction/{award_id}/ | Count award transactions | — | — | — |
GET |
/awards/last_updated/ | Get last update date | — | — | — |
GET |
/awards/{award_id}/ | Get award details | none | 404 | 770ms |
GET |
/budget_functions/list_budget_functions/ | List budget functions | — | — | — |
GET |
/bulk_download/status/ | Get bulk download status | — | — | — |
GET |
/disaster/overview/ | Get disaster funding overview | none | 404 | 770ms |
GET |
/download/status/ | Get download status | — | — | — |
GET |
/federal_accounts/{account_code}/ | Get federal account details | — | — | — |
GET |
/federal_accounts/{account_code}/fiscal_year_snapshot/ | Get federal account latest snapshot | — | — | — |
GET |
/federal_accounts/{account_code}/fiscal_year_snapshot/{year}/ | Get federal account fiscal year snapshot | — | — | — |
GET |
/federal_accounts/{federal_account_code}/ | Get federal account | none | 200 | 1498ms |
GET |
/federal_obligations/ | Get federal obligations | — | — | — |
GET |
/financial_balances/agencies/ | Get financial balances by agency | — | — | — |
GET |
/idvs/amounts/{award_id}/ | Get IDV amounts | — | — | — |
GET |
/recipient/children/{duns_or_uei}/ | Get recipient children | — | — | — |
GET |
/recipient/duns/{hash_value}/ | Get recipient by DUNS | — | — | — |
GET |
/recipient/state/awards/{fips}/ | Get state awards breakdown | — | — | — |
GET |
/recipient/state/{fips}/ | Get state details | none | 404 | 786ms |
GET |
/recipient/{hash_value}/ | Get recipient details | — | — | — |
GET |
/references/agency/{agency_id}/ | Get agency details | — | — | — |
GET |
/references/assistance_listing/ | Get assistance listings (CFDA) | — | — | — |
GET |
/references/award_types/ | Get award type mappings | — | 200 | 787ms |
GET |
/references/cfda/totals/ | Get CFDA totals | — | 204 | 1259ms |
GET |
/references/data_dictionary/ | Get data dictionary | none | 404 | 756ms |
GET |
/references/def_codes/ | Get DEF codes | none | 200 | 774ms |
GET |
/references/filter_tree/psc/ | Get PSC filter tree | — | — | — |
GET |
/references/filter_tree/tas/ | Get TAS filter tree | — | — | — |
GET |
/references/glossary/ | List glossary terms | — | 200 | 1285ms |
GET |
/references/naics/ | List NAICS codes | — | 200 | 788ms |
GET |
/references/naics/{naics_code}/ | Get NAICS details | — | — | — |
GET |
/references/submission_periods/ | Get submission periods | — | — | — |
GET |
/references/toptier_agencies/ | List all toptier agencies | none | 200 | 1195ms |
GET |
/references/total_budgetary_resources/ | Get total budgetary resources | — | — | — |
GET |
/reporting/agencies/overview/ | Get reporting agencies overview | — | — | — |
GET |
/reporting/agencies/publish_dates/ | Get agency publish dates | — | — | — |
GET |
/reporting/agencies/{toptier_code}/overview/ | Get agency reporting overview | — | — | — |