USAspending
Public recordsUSapi.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 creditReturns an agency's obligations for a fiscal year split into contracts, grants, direct payments, loans, idvs and other.
GET /v1/data/usaspending/agency-award-counts1 creditReturns every awarding agency for a fiscal year with its count of contracts, idvs, grants, direct payments, loans and other awards.
GET /v1/data/usaspending/agency-awards1 creditReturns an agency's transaction count, total obligations and latest action date for a fiscal year.
GET /v1/data/usaspending/agency-budgetary-resources1 creditReturns an agency's total budgetary resources, obligations and outlays for every fiscal year on record, plus obligation by fiscal period within each year.
GET /v1/data/usaspending/agency-budget-function-count1 creditReturns how many distinct budget functions and sub-functions an agency spent against in a fiscal year.
GET /v1/data/usaspending/agency-budget-functions1 creditReturns an agency's obligated and outlaid amounts for a fiscal year grouped by OMB budget function and sub-function.
GET /v1/data/usaspending/agency-federal-account-count1 creditReturns how many federal accounts and treasury accounts an agency spent from in a fiscal year.
GET /v1/data/usaspending/agency-federal-accounts1 creditReturns the federal accounts an agency spent from in a fiscal year, each with obligated and gross outlay amounts and its treasury account children.
GET /v1/data/usaspending/agency-financial-balances1 creditReturns an agency's budget authority, obligated amount, outlay and unobligated balance for a fiscal year, from the agency's own financial submissions.
GET /v1/data/usaspending/agency-new-award-count1 creditReturns how many brand-new awards (base awards, not modifications) an agency made in a fiscal year.
GET /v1/data/usaspending/agency-object-class-count1 creditReturns how many distinct object classes an agency spent against in a fiscal year.
GET /v1/data/usaspending/agency-object-classes1 creditReturns an agency's obligated and gross outlay amounts for a fiscal year grouped by major object class (personnel, contractual services, grants and so on).
GET /v1/data/usaspending/agency-overview1 creditReturns 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.
GET /v1/data/usaspending/agency-program-activities1 creditReturns an agency's obligated and gross outlay amounts for a fiscal year grouped by program activity, the agency's own named programmes.
GET /v1/data/usaspending/agency-program-activity-count1 creditReturns how many distinct program activities an agency spent against in a fiscal year.
GET /v1/data/usaspending/agency-reference1 creditReturns an agency's name, active fiscal year and quarter, outlay, obligated and budget authority amounts, and its share of the total federal budget.
GET /v1/data/usaspending/agency-sub-agencies1 creditReturns 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.
GET /v1/data/usaspending/agency-sub-agency-count1 creditReturns how many sub-agencies and offices an agency awarded or funded through in a fiscal year.
GET /v1/data/usaspending/agency-sub-component-accounts1 creditReturns the federal accounts belonging to one bureau of an agency for a fiscal year, with obligations, outlays and budgetary resources per account.
GET /v1/data/usaspending/agency-sub-components1 creditReturns the bureaus (sub-components) of an agency for a fiscal year with total obligations, outlays and budgetary resources, each with a bureau slug.
GET /v1/data/usaspending/assistance-listings1 creditReturns the Assistance Listing (CFDA) programme codes and titles that begin with a two-digit prefix.
GET /v1/data/usaspending/award1 creditReturns 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.
GET /v1/data/usaspending/award-federal-account-count1 creditReturns how many distinct federal accounts funded one award, as a single integer.
GET /v1/data/usaspending/awards-last-updated1 creditReturns the date on which USAspending's award data was last refreshed, as MM/DD/YYYY.
GET /v1/data/usaspending/award-spending-by-recipient1 creditReturns the recipients an awarding agency obligated money to in a fiscal year, with the obligated amount per recipient.
GET /v1/data/usaspending/award-subaward-count1 creditReturns the number of subawards reported under one prime award, as a single integer.
GET /v1/data/usaspending/award-transaction-count1 creditReturns the number of transactions (modifications) recorded against one award, as a single integer.
GET /v1/data/usaspending/award-types1 creditReturns every award type code grouped by family (contracts, idvs, grants, direct payments, loans, other) with its human-readable meaning.
GET /v1/data/usaspending/budget-functions1 creditReturns every OMB budget function with its three-digit code and title.
GET /v1/data/usaspending/countries1 creditReturns every country USAspending recognises, with its three-letter code and name.
GET /v1/data/usaspending/data-dictionary1 creditReturns 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.
GET /v1/data/usaspending/def-codes1 creditReturns every Disaster Emergency Fund Code (DEFC) with its public law, title, disaster category and the law's text URLs.
GET /v1/data/usaspending/federal-account1 creditReturns one federal account's profile: numeric id, agency identifier, main account code, title, parent agency and the treasury accounts it contains.
GET /v1/data/usaspending/federal-account-object-classes1 creditReturns the major object classes, each with its minor object classes, that have spending recorded against one federal account.
GET /v1/data/usaspending/federal-account-program-activities1 creditReturns the program activity codes and names recorded against one federal account.
GET /v1/data/usaspending/federal-account-snapshot1 creditReturns the latest fiscal year's budget snapshot for one federal account: outlay, budget authority, obligated, unobligated, balance brought forward and appropriations.
GET /v1/data/usaspending/federal-account-snapshot-year1 creditReturns one federal account's budget snapshot for a named fiscal year: outlay, budget authority, obligated, unobligated, balance brought forward and appropriations.
GET /v1/data/usaspending/federal-obligations1 creditReturns every federal account a funding agency obligated money from in a fiscal year, with the obligated amount per account.
GET /v1/data/usaspending/glossary1 creditReturns USAspending's glossary of federal spending terms, each with a plain-language definition, official definition and source links.
GET /v1/data/usaspending/idv-amounts1 creditReturns 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.
GET /v1/data/usaspending/idv-federal-account-count1 creditReturns the number of federal accounts that funded an indefinite delivery vehicle and its children, as a single integer.
GET /v1/data/usaspending/naics-code1 creditReturns one NAICS code with its description, retirement year, award count and immediate child codes.
GET /v1/data/usaspending/naics-tree1 creditReturns NAICS industry codes with their descriptions and award counts, as a tree: top-level sectors by default, or matching branches when filtered.
GET /v1/data/usaspending/psc-group1 creditReturns the PSC groups inside one top-level category, each with its single-letter or two-digit code, description and count.
GET /v1/data/usaspending/psc-subgroup1 creditReturns the PSC codes nested under one group letter within a top-level category, with descriptions and counts.
GET /v1/data/usaspending/psc-tree1 creditReturns the top level of the Product Service Code hierarchy - Product, Service and Research and Development - each with the number of codes beneath it.
GET /v1/data/usaspending/recipient1 creditReturns one recipient's profile: legal and alternate names, UEI and DUNS, parent entity, business categories, location, and total federal money received.
GET /v1/data/usaspending/recipient-children1 creditReturns the child recipient entities rolled up under one parent UEI or DUNS, each with its recipient id, state and amount received.
GET /v1/data/usaspending/recipient-state1 creditReturns one state's profile: name, code, FIPS, population, median household income, award total and award count.
GET /v1/data/usaspending/recipient-state-awards1 creditReturns one state's federal money split by award category: contracts, grants, direct payments, loans and other, each with amount, count and outlays.
GET /v1/data/usaspending/recipient-states1 creditReturns every U.S. state, district and territory with the total federal award dollars and award count recorded for it.
GET /v1/data/usaspending/reporting-agencies-overview1 creditReturns, 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.
GET /v1/data/usaspending/reporting-agency-overview1 creditReturns 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.
GET /v1/data/usaspending/reporting-differences1 creditReturns, per treasury account, the gap between an agency's File A and File B obligation figures for one fiscal period.
GET /v1/data/usaspending/reporting-discrepancies1 creditReturns 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.
GET /v1/data/usaspending/reporting-publish-dates1 creditReturns, per agency for a fiscal year, the publication and certification dates of each period's financial submission and how many times it was published.
GET /v1/data/usaspending/reporting-submission-history1 creditReturns every publication and certification timestamp for one agency's financial submission in a single fiscal period.
GET /v1/data/usaspending/reporting-unlinked-awards1 creditReturns, 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.
GET /v1/data/usaspending/spending-by-major-object-class1 creditReturns an agency's obligated amount for a fiscal year grouped by major object class code and name.
GET /v1/data/usaspending/spending-by-object-class1 creditReturns an agency's obligated amount for a fiscal year broken into the individual object classes within one major object class.
GET /v1/data/usaspending/states1 creditReturns every U.S. state, district and territory with its FIPS code, two-letter code and name.
GET /v1/data/usaspending/submission-periods1 creditReturns the reporting calendar: every fiscal year and period with its start and end dates, submission window, certification deadline and whether the window is open.
GET /v1/data/usaspending/tas-account-symbols1 creditReturns the individual treasury account symbols inside one federal account, each with its full TAS string and title.
GET /v1/data/usaspending/tas-agency-accounts1 creditReturns the federal accounts belonging to one agency identifier, each with its AID-MAIN code and account title.
GET /v1/data/usaspending/tas-tree1 creditReturns every agency that owns treasury accounts, with its agency identifier, name and the number of accounts beneath it.
GET /v1/data/usaspending/toptier-agencies1 creditReturns every toptier federal agency with its toptier code, internal agency id, abbreviation, name, active fiscal year, budget authority, obligations and outlays.
GET /v1/data/usaspending/total-budgetary-resources1 creditReturns total federal budgetary resources by fiscal year and fiscal period across all agencies.
GET /v1/data/usaspending/treasury-account-object-classes1 creditReturns one treasury account symbol's obligated and gross outlay amounts for a fiscal year grouped by major and minor object class.
GET /v1/data/usaspending/treasury-account-program-activities1 creditReturns one treasury account symbol's obligated and gross outlay amounts for a fiscal year grouped by program activity.
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/LICENSEAttribution
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
