Skip to main content
All providers

USAspending

Public recordsUS

api.usaspending.gov

The official U.S. government record of federal spending: every contract, grant, loan and direct payment, with the agencies, accounts and recipients behind them.

Capabilities (69)

GET /v1/data/usaspending/agency-award-category-obligations1 credit

Returns an agency's obligations for a fiscal year split into contracts, grants, direct payments, loans, idvs and other.

toptier_codefiscal_year
GET /v1/data/usaspending/agency-award-counts1 credit

Returns every awarding agency for a fiscal year with its count of contracts, idvs, grants, direct payments, loans and other awards.

fiscal_yeargroup?
GET /v1/data/usaspending/agency-awards1 credit

Returns an agency's transaction count, total obligations and latest action date for a fiscal year.

toptier_codefiscal_yearagency_type?award_type_codes?
GET /v1/data/usaspending/agency-budgetary-resources1 credit

Returns an agency's total budgetary resources, obligations and outlays for every fiscal year on record, plus obligation by fiscal period within each year.

toptier_code
GET /v1/data/usaspending/agency-budget-function-count1 credit

Returns how many distinct budget functions and sub-functions an agency spent against in a fiscal year.

toptier_codefiscal_year
GET /v1/data/usaspending/agency-budget-functions1 credit

Returns an agency's obligated and outlaid amounts for a fiscal year grouped by OMB budget function and sub-function.

toptier_codefiscal_yearpage?limit?
GET /v1/data/usaspending/agency-federal-account-count1 credit

Returns how many federal accounts and treasury accounts an agency spent from in a fiscal year.

toptier_codefiscal_year
GET /v1/data/usaspending/agency-federal-accounts1 credit

Returns the federal accounts an agency spent from in a fiscal year, each with obligated and gross outlay amounts and its treasury account children.

toptier_codefiscal_yearfilter?order?sort?page?limit?
GET /v1/data/usaspending/agency-financial-balances1 credit

Returns an agency's budget authority, obligated amount, outlay and unobligated balance for a fiscal year, from the agency's own financial submissions.

fiscal_yearfunding_agency_id
GET /v1/data/usaspending/agency-new-award-count1 credit

Returns how many brand-new awards (base awards, not modifications) an agency made in a fiscal year.

toptier_codefiscal_yearagency_type?award_type_codes?
GET /v1/data/usaspending/agency-object-class-count1 credit

Returns how many distinct object classes an agency spent against in a fiscal year.

toptier_codefiscal_year
GET /v1/data/usaspending/agency-object-classes1 credit

Returns an agency's obligated and gross outlay amounts for a fiscal year grouped by major object class (personnel, contractual services, grants and so on).

toptier_codefiscal_yearfilter?order?sort?page?limit?
GET /v1/data/usaspending/agency-overview1 credit

Returns one agency's profile for a fiscal year: name, abbreviation, mission, website, budgetary resources, obligations, number of federal accounts and recipients, and congressional justification links.

toptier_codefiscal_year
GET /v1/data/usaspending/agency-program-activities1 credit

Returns an agency's obligated and gross outlay amounts for a fiscal year grouped by program activity, the agency's own named programmes.

toptier_codefiscal_yearfilter?order?sort?page?limit?
GET /v1/data/usaspending/agency-program-activity-count1 credit

Returns how many distinct program activities an agency spent against in a fiscal year.

toptier_codefiscal_year
GET /v1/data/usaspending/agency-reference1 credit

Returns an agency's name, active fiscal year and quarter, outlay, obligated and budget authority amounts, and its share of the total federal budget.

id
GET /v1/data/usaspending/agency-sub-agencies1 credit

Returns the sub-agencies (bureaus) under a toptier agency for a fiscal year, each with total obligations, transaction and new-award counts, and its child offices.

toptier_codefiscal_yearagency_type?award_type_codes?order?sort?page?limit?
GET /v1/data/usaspending/agency-sub-agency-count1 credit

Returns how many sub-agencies and offices an agency awarded or funded through in a fiscal year.

toptier_codefiscal_yearagency_type?
GET /v1/data/usaspending/agency-sub-component-accounts1 credit

Returns the federal accounts belonging to one bureau of an agency for a fiscal year, with obligations, outlays and budgetary resources per account.

toptier_codebureau_slugfiscal_yearagency_type?order?sort?page?limit?
GET /v1/data/usaspending/agency-sub-components1 credit

Returns the bureaus (sub-components) of an agency for a fiscal year with total obligations, outlays and budgetary resources, each with a bureau slug.

toptier_codefiscal_yearagency_type?order?sort?page?limit?
GET /v1/data/usaspending/assistance-listings1 credit

Returns the Assistance Listing (CFDA) programme codes and titles that begin with a two-digit prefix.

code
GET /v1/data/usaspending/award1 credit

Returns the full profile of one prime award: amounts obligated and outlayed, dates, award type, description, recipient, awarding and funding agency, place of performance, NAICS and PSC hierarchy.

award_id
GET /v1/data/usaspending/award-federal-account-count1 credit

Returns how many distinct federal accounts funded one award, as a single integer.

award_id
GET /v1/data/usaspending/awards-last-updated1 credit

Returns the date on which USAspending's award data was last refreshed, as MM/DD/YYYY.

No parameters
GET /v1/data/usaspending/award-spending-by-recipient1 credit

Returns the recipients an awarding agency obligated money to in a fiscal year, with the obligated amount per recipient.

fiscal_yearawarding_agency_idlimit?page?
GET /v1/data/usaspending/award-subaward-count1 credit

Returns the number of subawards reported under one prime award, as a single integer.

award_id
GET /v1/data/usaspending/award-transaction-count1 credit

Returns the number of transactions (modifications) recorded against one award, as a single integer.

award_id
GET /v1/data/usaspending/award-types1 credit

Returns every award type code grouped by family (contracts, idvs, grants, direct payments, loans, other) with its human-readable meaning.

No parameters
GET /v1/data/usaspending/budget-functions1 credit

Returns every OMB budget function with its three-digit code and title.

No parameters
GET /v1/data/usaspending/countries1 credit

Returns every country USAspending recognises, with its three-letter code and name.

No parameters
GET /v1/data/usaspending/data-dictionary1 credit

Returns the full data dictionary for USAspending's bulk download files: every column name, its plain-language title, definition, allowed values and which files it appears in.

No parameters
GET /v1/data/usaspending/def-codes1 credit

Returns every Disaster Emergency Fund Code (DEFC) with its public law, title, disaster category and the law's text URLs.

No parameters
GET /v1/data/usaspending/federal-account1 credit

Returns one federal account's profile: numeric id, agency identifier, main account code, title, parent agency and the treasury accounts it contains.

account_numberfiscal_year?
GET /v1/data/usaspending/federal-account-object-classes1 credit

Returns the major object classes, each with its minor object classes, that have spending recorded against one federal account.

federal_account_id
GET /v1/data/usaspending/federal-account-program-activities1 credit

Returns the program activity codes and names recorded against one federal account.

federal_account_codelimit?page?order?sort?
GET /v1/data/usaspending/federal-account-snapshot1 credit

Returns the latest fiscal year's budget snapshot for one federal account: outlay, budget authority, obligated, unobligated, balance brought forward and appropriations.

federal_account_id
GET /v1/data/usaspending/federal-account-snapshot-year1 credit

Returns one federal account's budget snapshot for a named fiscal year: outlay, budget authority, obligated, unobligated, balance brought forward and appropriations.

federal_account_idfiscal_year
GET /v1/data/usaspending/federal-obligations1 credit

Returns every federal account a funding agency obligated money from in a fiscal year, with the obligated amount per account.

fiscal_yearfunding_agency_idlimit?page?
GET /v1/data/usaspending/glossary1 credit

Returns USAspending's glossary of federal spending terms, each with a plain-language definition, official definition and source links.

limit?page?
GET /v1/data/usaspending/idv-amounts1 credit

Returns the rollup counts and dollar totals for an indefinite delivery vehicle: child IDV count, child award count, and combined obligation, exercised-option and potential values.

award_id
GET /v1/data/usaspending/idv-federal-account-count1 credit

Returns the number of federal accounts that funded an indefinite delivery vehicle and its children, as a single integer.

award_idpiid?
GET /v1/data/usaspending/naics-code1 credit

Returns one NAICS code with its description, retirement year, award count and immediate child codes.

code
GET /v1/data/usaspending/naics-tree1 credit

Returns NAICS industry codes with their descriptions and award counts, as a tree: top-level sectors by default, or matching branches when filtered.

filter?
GET /v1/data/usaspending/psc-group1 credit

Returns the PSC groups inside one top-level category, each with its single-letter or two-digit code, description and count.

groupdepth?filter?
GET /v1/data/usaspending/psc-subgroup1 credit

Returns the PSC codes nested under one group letter within a top-level category, with descriptions and counts.

grouppscdepth?filter?
GET /v1/data/usaspending/psc-tree1 credit

Returns the top level of the Product Service Code hierarchy - Product, Service and Research and Development - each with the number of codes beneath it.

depth?filter?
GET /v1/data/usaspending/recipient1 credit

Returns one recipient's profile: legal and alternate names, UEI and DUNS, parent entity, business categories, location, and total federal money received.

recipient_idyear?
GET /v1/data/usaspending/recipient-children1 credit

Returns the child recipient entities rolled up under one parent UEI or DUNS, each with its recipient id, state and amount received.

duns_or_ueiyear?
GET /v1/data/usaspending/recipient-state1 credit

Returns one state's profile: name, code, FIPS, population, median household income, award total and award count.

fipsyear?
GET /v1/data/usaspending/recipient-state-awards1 credit

Returns one state's federal money split by award category: contracts, grants, direct payments, loans and other, each with amount, count and outlays.

fipsyear?
GET /v1/data/usaspending/recipient-states1 credit

Returns every U.S. state, district and territory with the total federal award dollars and award count recorded for it.

No parameters
GET /v1/data/usaspending/reporting-agencies-overview1 credit

Returns, for every agency, its submission status and data-quality figures: total budgetary authority, percentage of obligations covered by linked awards, unlinked award counts and assurance statement links.

fiscal_year?fiscal_period?filter?page?limit?order?sort?
GET /v1/data/usaspending/reporting-agency-overview1 credit

Returns one agency's submission and data-quality figures for every fiscal year and period it has reported: budget authority, obligation coverage, unlinked awards and assurance statements.

toptier_codepage?limit?order?sort?
GET /v1/data/usaspending/reporting-differences1 credit

Returns, per treasury account, the gap between an agency's File A and File B obligation figures for one fiscal period.

toptier_codefiscal_yearfiscal_periodpage?limit?order?sort?
GET /v1/data/usaspending/reporting-discrepancies1 credit

Returns the treasury accounts that appear in an agency's award files but are missing from its appropriation file for one fiscal period, with the amounts involved.

toptier_codefiscal_yearfiscal_periodpage?limit?order?sort?
GET /v1/data/usaspending/reporting-publish-dates1 credit

Returns, per agency for a fiscal year, the publication and certification dates of each period's financial submission and how many times it was published.

fiscal_yearfilter?page?limit?order?sort?
GET /v1/data/usaspending/reporting-submission-history1 credit

Returns every publication and certification timestamp for one agency's financial submission in a single fiscal period.

toptier_codefiscal_yearfiscal_periodpage?limit?order?sort?
GET /v1/data/usaspending/reporting-unlinked-awards1 credit

Returns, for one agency and fiscal period, how many award records could not be linked between the financial files and the award files, and how many were linked.

toptier_codefiscal_yearfiscal_periodtype
GET /v1/data/usaspending/spending-by-major-object-class1 credit

Returns an agency's obligated amount for a fiscal year grouped by major object class code and name.

fiscal_yearfunding_agency_id
GET /v1/data/usaspending/spending-by-object-class1 credit

Returns an agency's obligated amount for a fiscal year broken into the individual object classes within one major object class.

fiscal_yearfunding_agency_idmajor_object_class_code
GET /v1/data/usaspending/states1 credit

Returns every U.S. state, district and territory with its FIPS code, two-letter code and name.

No parameters
GET /v1/data/usaspending/submission-periods1 credit

Returns the reporting calendar: every fiscal year and period with its start and end dates, submission window, certification deadline and whether the window is open.

use_cache?
GET /v1/data/usaspending/tas-account-symbols1 credit

Returns the individual treasury account symbols inside one federal account, each with its full TAS string and title.

agencyfederal_accountdepth?filter?
GET /v1/data/usaspending/tas-agency-accounts1 credit

Returns the federal accounts belonging to one agency identifier, each with its AID-MAIN code and account title.

agencydepth?filter?
GET /v1/data/usaspending/tas-tree1 credit

Returns every agency that owns treasury accounts, with its agency identifier, name and the number of accounts beneath it.

depth?filter?
GET /v1/data/usaspending/toptier-agencies1 credit

Returns every toptier federal agency with its toptier code, internal agency id, abbreviation, name, active fiscal year, budget authority, obligations and outlays.

sort?order?
GET /v1/data/usaspending/total-budgetary-resources1 credit

Returns total federal budgetary resources by fiscal year and fiscal period across all agencies.

fiscal_year?fiscal_period?
GET /v1/data/usaspending/treasury-account-object-classes1 credit

Returns one treasury account symbol's obligated and gross outlay amounts for a fiscal year grouped by major and minor object class.

tasfiscal_yearfilter?order?sort?page?limit?
GET /v1/data/usaspending/treasury-account-program-activities1 credit

Returns one treasury account symbol's obligated and gross outlay amounts for a fiscal year grouped by program activity.

tasfiscal_yearfilter?order?sort?page?limit?

Licence

The USAspending API's own licence statement (CONTRIBUTING.md, repository fedspendingtransparency/usaspending-api): "Note: this codebase supports a Federal US Government website. This project is in the public domain within the United States, and copyright and related rights in the work worldwide are waived through the CC0 1.0 Universal public domain dedication." The repository LICENSE file is the full CC0 1.0 Universal text, whose Statement of Purpose says the work may be reused "as freely as possible in any form whatsoever and for any purposes, including without limitation commercial purposes." The data served is a work of the U.S. federal government.

https://github.com/fedspendingtransparency/usaspending-api/blob/master/LICENSE

Attribution

Display this wherever you show the data. It arrives on every response as provenance.attribution_text.

Source: USAspending.gov, U.S. Department of the Treasury (public domain, CC0 1.0).

Cache: up to 3600s