API reference
All 176 endpoints, grouped under usaspending.gov's four menus and the feature that calls each one.
GET78POST98
Search Award Data
The endpoints behind Advanced Search, keyword search, and natural-language search.
- POSTGenerated Filter Hash for URL
/api/v2/references/filter/ - POSTRestore Filters From URL Hash
/api/v2/references/hash/ - POSTNew Awards Over Time
/api/v2/search/new_awards_over_time/ - POSTNumber of awards for each type
/api/v2/search/spending_by_award_count/ - POSTSpending by Award
/api/v2/search/spending_by_award/ - POSTSpending By Category
/api/v2/search/spending_by_category/ - POSTSpending By Awarding Agency
/api/v2/search/spending_by_category/awarding_agency/ - POSTSpending By Awarding Subagency
/api/v2/search/spending_by_category/awarding_subagency/ - POSTSpending By CFDA
/api/v2/search/spending_by_category/cfda/ - POSTSpending By Country
/api/v2/search/spending_by_category/country/ - POSTSpending By County
/api/v2/search/spending_by_category/county/ - POSTSpending By DEFC
/api/v2/search/spending_by_category/defc/ - POSTSpending By District
/api/v2/search/spending_by_category/district/ - POSTSpending By Federal Account
/api/v2/search/spending_by_category/federal_account/ - POSTSpending By Funding Agency
/api/v2/search/spending_by_category/funding_agency/ - POSTSpending By Funding Subagency
/api/v2/search/spending_by_category/funding_subagency/ - POSTSpending By NAICS
/api/v2/search/spending_by_category/naics/ - POSTSpending By PSC
/api/v2/search/spending_by_category/psc/ - POSTSpending By Recipient DUNS
/api/v2/search/spending_by_category/recipient_duns/ - POSTSpending By Recipient
/api/v2/search/spending_by_category/recipient/ - POSTSpending By State Territory
/api/v2/search/spending_by_category/state_territory/ - POSTSpending by Geography
/api/v2/search/spending_by_geography/ - POSTSpending By Subaward Grouped
/api/v2/search/spending_by_subaward_grouped/ - POSTSpending Over Time
/api/v2/search/spending_over_time/
- POSTAvailability Type Code
/api/v2/autocomplete/accounts/a/ - POSTAgency Identifier
/api/v2/autocomplete/accounts/aid/ - POSTAllocation Transfer Agency Identifier
/api/v2/autocomplete/accounts/ata/ - POSTBeginning Period of Availability
/api/v2/autocomplete/accounts/bpoa/ - POSTEnding Period of Availability
/api/v2/autocomplete/accounts/epoa/ - POSTMain Account Code
/api/v2/autocomplete/accounts/main/ - POSTSub Account Code
/api/v2/autocomplete/accounts/sub/ - POSTAwarding Agency and Office Autocomplete
/api/v2/autocomplete/awarding_agency_office/ - POSTAwarding Agency Autocomplete
/api/v2/autocomplete/awarding_agency/ - POSTCFDA Autocomplete
/api/v2/autocomplete/cfda/ - POSTAdvanced Search City Autocomplete
/api/v2/autocomplete/city/ - POSTFunding Agency and Office Autocomplete
/api/v2/autocomplete/funding_agency_office/ - POSTFunding Agency Autocomplete
/api/v2/autocomplete/funding_agency/ - POSTGlossary Autocomplete
/api/v2/autocomplete/glossary/ - POSTLocation Autocomplete
/api/v2/autocomplete/location/ - POSTNAICS Autocomplete
/api/v2/autocomplete/naics/ - POSTPSC Autocomplete
/api/v2/autocomplete/program_activity/ - POSTPSC Autocomplete
/api/v2/autocomplete/psc/ - POSTRecipient Autocomplete
/api/v2/autocomplete/recipient/ - GETToptier Search
/api/v2/references/filter_tree/psc/ - GETToptier Search
/api/v2/references/filter_tree/psc/{group}/ - GETToptier Search
/api/v2/references/filter_tree/psc/{group}/{psc}/ - GETToptier Search
/api/v2/references/filter_tree/psc/{group}/{psc}/{psc2}/ - GETToptier Search
/api/v2/references/filter_tree/tas/ - GETSearch by Agency
/api/v2/references/filter_tree/tas/{agency}/ - GETSearch by Federal Account
/api/v2/references/filter_tree/tas/{agency}/{federal_account}/
Explore the Data
The endpoints behind Spending Explorer and the agency, account, state, recipient, award, and COVID-19 profiles.
- GETAgency Overview
/api/v2/agency/{toptier_code}/ - GETAgency Awards
/api/v2/agency/{toptier_code}/awards/ - GETOverview of new awards for Agency
/api/v2/agency/{toptier_code}/awards/new/count - GETList Budget Function
/api/v2/agency/{toptier_code}/budget_function/ - GETBudget Function Count
/api/v2/agency/{toptier_code}/budget_function/count/ - GETAgency Overview
/api/v2/agency/{toptier_code}/budgetary_resources/ - GETList Disaster Emergency Fund Codes
/api/v2/agency/{toptier_code}/def_code/ - GETList Federal Accounts
/api/v2/agency/{toptier_code}/federal_account/ - GETFederal Account Count
/api/v2/agency/{toptier_code}/federal_account/count/ - GETList Object Classes
/api/v2/agency/{toptier_code}/object_class/ - GETObject Class Count
/api/v2/agency/{toptier_code}/object_class/count/ - GETFederal Obligations
/api/v2/agency/{toptier_code}/obligations_by_award_category/ - GETList Program Activities
/api/v2/agency/{toptier_code}/program_activity/ - GETProgram Activity Count
/api/v2/agency/{toptier_code}/program_activity/count/ - GETList Federal Accounts
/api/v2/agency/{toptier_code}/sub_agency/ - GETSub-Agency Count
/api/v2/agency/{toptier_code}/sub_agency/count/ - GETList Sub-Components
/api/v2/agency/{toptier_code}/sub_components/ - GETList Federal Accounts by Sub-Component
/api/v2/agency/{toptier_code}/sub_components/{bureau_slug}/ - GETCount of awards for Agencies
/api/v2/agency/awards/count - GETTreasury Account's Object Classes
/api/v2/agency/treasury_account/{tas}/object_class/ - GETTreasury Account's Program Activities
/api/v2/agency/treasury_account/{tas}/program_activity/ - GETAgency Overview
/api/v2/references/agency/{id}/ - GETDABS Submission Window Dates
/api/v2/references/submission_periods/ - GETToptier Agency Profile
/api/v2/references/toptier_agencies/ - GETTotal Government Budgetary Resources
/api/v2/references/total_budgetary_resources/
- POSTFederal Accounts Landing Page
/api/v2/federal_accounts/ - GETFederal Accounts Landing Page
/api/v2/federal_accounts/{account_number}/ - POSTObject Classes Total
/api/v2/federal_accounts/{federal_account_code}/object_classes/total - GETProgram Activities
/api/v2/federal_accounts/{federal_account_code}/program_activities/ - POSTProgram Activities Total
/api/v2/federal_accounts/{federal_account_code}/program_activities/total - GETAvailable Object Classes
/api/v2/federal_accounts/{federal_account_id}/available_object_classes - GETList of Available Program Activities
/api/v2/federal_accounts/{federal_account_id}/available_program_activities - GETFiscal Year Snapshot
/api/v2/federal_accounts/{federal_account_id}/fiscal_year_snapshot/ - GETFiscal Year Snapshot
/api/v2/federal_accounts/{federal_account_id}/fiscal_year_snapshot/{fiscal_year}/ - GETFederal Obligations
/api/v2/federal_obligations/ - GETAgency Profile
/api/v2/financial_balances/agencies/ - GETMajor Object Classes
/api/v2/financial_spending/major_object_class/ - GETMinor Object Classes
/api/v2/financial_spending/object_class/
- GETAwards
/api/v2/awards/{award_id}/ - POSTList Federal Accounts
/api/v2/awards/accounts/ - GETFederal Accounts Count
/api/v2/awards/count/federal_account/{award_id}/ - GETSubaward Count
/api/v2/awards/count/subaward/{award_id}/ - GETTransaction Count
/api/v2/awards/count/transaction/{award_id}/ - POSTAward Funding Rollup
/api/v2/awards/funding_rollup/ - POSTAward Funding
/api/v2/awards/funding/ - GETAwards Last Updated
/api/v2/awards/last_updated/ - POSTList Federal Accounts
/api/v2/idvs/accounts/ - POSTIDV Activity
/api/v2/idvs/activity/ - GETIDV Award Amounts
/api/v2/idvs/amounts/{award_id}/ - POSTIDV Related Awards
/api/v2/idvs/awards/ - GETFederal Accounts Count
/api/v2/idvs/count/federal_account/{award_id}/ - POSTIDV Funding Rollup
/api/v2/idvs/funding_rollup/ - POSTIDV Funding
/api/v2/idvs/funding/ - POSTSubawards
/api/v2/subawards/ - POSTTransactions
/api/v2/transactions/
- POSTCount of Agencies Receiving Disaster/Emergency Funding
/api/v2/disaster/agency/count/ - POSTAgencies Spending Disaster/Emergency Funding via Loans
/api/v2/disaster/agency/loans/ - POSTAgencies Spending Disaster/Emergency Funding
/api/v2/disaster/agency/spending/ - POSTAggregated Award Spending From Disaster/Emergency Funding
/api/v2/disaster/award/amount/ - POSTCount of Awards Receiving Disaster/Emergency Funding
/api/v2/disaster/award/count/ - POSTCount of CFDA Receiving Disaster/Emergency Funding
/api/v2/disaster/cfda/count/ - POSTCFDA Programs Spending Disaster/Emergency Funding via Loans
/api/v2/disaster/cfda/loans/ - POSTCFDA Programs Spending Disaster/Emergency Funding
/api/v2/disaster/cfda/spending/ - POSTCount of DEF Codes Receiving Disaster/Emergency Funding
/api/v2/disaster/def_code/count/ - POSTCount of Federal Accounts Receiving Disaster/Emergency Funding
/api/v2/disaster/federal_account/count/ - POSTFederal Account Spending Disaster/Emergency Funding via Loans
/api/v2/disaster/federal_account/loans/ - POSTFederal Account Spending Disaster/Emergency Funding
/api/v2/disaster/federal_account/spending/ - POSTCount of Object Classes Receiving Disaster/Emergency Funding
/api/v2/disaster/object_class/count/ - POSTAgencies Spending Disaster/Emergency Funding via Loans
/api/v2/disaster/object_class/loans/ - POSTObject Classes Spending Disaster/Emergency Funding
/api/v2/disaster/object_class/spending/ - GETDisaster Spending Overview
/api/v2/disaster/overview/ - POSTCount of Recipients Receiving Disaster/Emergency Funding
/api/v2/disaster/recipient/count/ - POSTRecipient Spending Disaster/Emergency Funding via Loans
/api/v2/disaster/recipient/loans/ - POSTRecipient Spending Disaster/Emergency Funding
/api/v2/disaster/recipient/spending/ - POSTDisaster Spending By Geography
/api/v2/disaster/spending_by_geography/ - GETDEF Code Types
/api/v2/references/def_codes/
Download the Data
The endpoints behind the Download Center: custom files, archives, and job status.
- GETList Budget Functions
/api/v2/budget_functions/list_budget_functions/ - POSTList Budget Subfunctions
/api/v2/budget_functions/list_budget_subfunctions/ - POSTCustom Account Data
/api/v2/download/accounts/ - POSTAssistance Download
/api/v2/download/assistance/ - POSTAward Download
/api/v2/download/awards/ - POSTContract Download
/api/v2/download/contract/ - POSTDownload Count
/api/v2/download/count/ - POSTDisaster Funding and Spending Download
/api/v2/download/disaster/ - POSTDisaster Recipient Download
/api/v2/download/disaster/recipients/ - POSTIDV Download
/api/v2/download/idv/ - POSTSearch Download
/api/v2/download/search/ - GETDownload Status
/api/v2/download/status - POSTAward Download
/api/v2/download/transactions/
Find Resources
Reference data, the glossary and data dictionary, and agency submission statistics.
- GETAssistance Listing
/api/v2/references/assistance_listing/{code} - GETAward Types
/api/v2/references/award_types/ - GETOpportunity Totals by CFDA
/api/v2/references/cfda/totals/ - GETOpportunity Totals by CFDA
/api/v2/references/cfda/totals/{cfda_code}/ - GETCountries
/api/v2/references/countries/ - GETData Dictionary
/api/v2/references/data_dictionary/ - GETGlossary
/api/v2/references/glossary/ - GETNAICS List
/api/v2/references/naics/ - GETSingle NAICS And Descendants
/api/v2/references/naics/{code}/
- GETAgencies Reporting Publish Dates History
/api/v2/reporting/agencies/{toptier_code}/{fiscal_year}/{fiscal_period}/submission_history/ - GETAgencies' Unlinked Awards
/api/v2/reporting/agencies/{toptier_code}/{fiscal_year}/{fiscal_period}/unlinked_awards/{type}/ - GETAgency Reporting Differences
/api/v2/reporting/agencies/{toptier_code}/differences/ - GETAgency Reporting Discrepancies
/api/v2/reporting/agencies/{toptier_code}/discrepancies/ - GETAgency Reporting Overview
/api/v2/reporting/agencies/{toptier_code}/overview/ - GETAgencies Reporting Overview
/api/v2/reporting/agencies/overview/ - GETAgency Reporting Publish Dates
/api/v2/reporting/agencies/publish_dates/