USAspending
App · 20 actions
Explore U.S. federal spending from USAspending.gov: search contracts, grants and loans, see who receives them, and get spending by agency, state, industry and over time.
Actions
| Action | What it does |
|---|---|
| Count awards | Count the awards that match a search, by kind: contracts, contract vehicles, grants, direct payments, loans and other assistance. |
| Get agency | Get an agency's profile: its mission, website, number of sub-agencies and budget justification. |
| Get agency budget | Get an agency's budgetary resources, obligations and outlays for a fiscal year, its share of the government's total, and the same figures for every year since 2017. |
| Get award | Get one award's details: amounts, dates, agencies, recipient, place of performance, industry or program, and its usaspending.gov page. |
| Get COVID-19 or infrastructure spending | Get how much Congress provided for COVID-19 relief or the Infrastructure Investment and Jobs Act, how much has been obligated and spent, and the funding from each law. |
| Get federal account | Get a federal account's budgetary resources, obligations and outlays for a fiscal year, and the Treasury accounts under it. |
| Get last updated date | Get the day USAspending last updated its award data, to check for new data before running a search. |
| Get recipient | Get a recipient's profile: UEI, parent company, address, business types and what it received over a period. |
| Get spending by state | Total federal award spending in each state and territory, with the amount per person, for the awards that match a search. |
| Get spending over time | Total federal award spending by year, quarter or month, split by kind of award, for the awards that match a search. |
| Get state profile | Get the federal awards going to a state or territory: total amount, number of awards, amount per person, population and median household income. |
| Get top spending by category | Rank where the money went for the awards that match a search: top recipients, agencies, industries, products, programs, states, countries or federal accounts, largest first. |
| List agencies | List every federal agency with its code, budget, obligations and share of the government's budget this fiscal year. |
| List award transactions | List the changes made to an award over time, such as new funding and modifications, newest first. |
| List sub-agencies | List an agency's sub-agencies and their offices, with what each obligated and how many new awards it made in a fiscal year. |
| List sub-awards | List the sub-awards a recipient passed on from an award, such as subcontracts, as the recipient reported them. |
| Look up codes | Find industry (NAICS), product and service (PSC) or assistance listing (CFDA) codes by word or number, to use in the other actions' filters. |
| Search awards | Find federal contracts, grants, loans and other awards by keyword, dates, agency, recipient, place or industry. |
| Search federal accounts | Find the accounts Congress funds agencies through, such as Grants to States for Medicaid, with each one's budget. |
| Search recipients | Find companies, nonprofits and governments that receive federal money, by name or UEI, with what each received in the last 12 months. |
Count awards
Count the awards that match a search, by kind: contracts, contract vehicles, grants, direct payments, loans and other assistance.
Inputs
- Award types
award_typeslist - Only these kinds of award. Leave all unticked for every kind.One or more of:
contracts,idvs(Contract vehicles (IDVs)),grants,direct_payments(Direct payments),loans,other(Other assistance). - Keywords
keywordslist - Words to look for in award descriptions and names, such as cybersecurity. Each needs at least 3 characters.
- From
start_datedate - Only spending on or after this day, back to 2007-10-01. Leave both dates empty for the last 12 months.
- To
end_datedate - Only spending on or before this day. Leave empty for today.
- Agency
agencytext - Only awards made by this agency.
- Sub-agency
sub_agencytext - Only awards made by this part of the agency, such as the Department of the Army. Pick an agency first to list its sub-agencies.
- Recipient
recipienttext - Only awards to this recipient: a name, such as Lockheed Martin, or a UEI.
- Place of performance
statetext - Only awards for work done in this state or territory.One of:
AL(Alabama),AK(Alaska),AS(American Samoa),AZ(Arizona),AR(Arkansas),CA(California),CO(Colorado),CT(Connecticut),DE(Delaware),DC(District of Columbia), and 46 more. - Industry codes (NAICS)
naics_codeslist - Only contracts in these industries, such as 541512. A shorter code covers everything under it (54 is professional services). Find codes with Look up codes.
- Product and service codes (PSC)
psc_codeslist - Only contracts for these products or services, such as 7030 for software. Find codes with Look up codes.
Outputs
contractsnumber- Contracts
direct_paymentsnumber- Direct payments
end_datetext- The last day searched (YYYY-MM-DD)
grantsnumber- Grants
idvsnumber- Contract vehicles (IDVs)
loansnumber- Loans
othernumber- Other assistance
start_datetext- The first day searched (YYYY-MM-DD)
totalnumber- All of them together
Example output
{
"contracts": 101311,
"direct_payments": 0,
"end_date": "2026-10-15",
"grants": 34,
"idvs": 0,
"loans": 0,
"other": 0,
"start_date": "2020-10-01",
"total": 101345
}Get agency
Get an agency's profile: its mission, website, number of sub-agencies and budget justification.
Inputs
- Agency
agencytextRequired - The federal agency. Pick one, or use an agency code from List agencies, such as 097 for the Department of Defense.
- Fiscal year
fiscal_yeartext - The federal fiscal year, which runs October to September. Leave empty for the latest year with published data.One of:
2027(FY 2027 (Oct 2026 to Sep 2027)),2026(FY 2026 (Oct 2025 to Sep 2026)),2025(FY 2025 (Oct 2024 to Sep 2025)),2024(FY 2024 (Oct 2023 to Sep 2024)),2023(FY 2023 (Oct 2022 to Sep 2023)),2022(FY 2022 (Oct 2021 to Sep 2022)),2021(FY 2021 (Oct 2020 to Sep 2021)),2020(FY 2020 (Oct 2019 to Sep 2020)),2019(FY 2019 (Oct 2018 to Sep 2019)),2018(FY 2018 (Oct 2017 to Sep 2018)),2017(FY 2017 (Oct 2016 to Sep 2017)).
Outputs
abbreviationtext- Abbreviation
about_the_datatext- USAspending's notes on its data, if any
budget_justification_urltext- Its congressional budget justification
fiscal_yearnumber- The fiscal year asked about
missiontext- Its mission statement
nametext- Name
sub_agency_countnumber- How many sub-agencies it has
toptier_codetext- The agency's code
urltext- Its page on usaspending.gov
websitetext- Its website
Example output
{
"abbreviation": "DOD",
"about_the_data": "For reasons of national security, Department of Defense contract and IDV data is subject to a 90-day publication delay.",
"budget_justification_url": "https://www.defense.gov/cj",
"fiscal_year": 2026,
"mission": "The mission of the Department of Defense is to provide the military forces needed to deter war and to protect the security of our country.",
"name": "Department of Defense",
"sub_agency_count": 36,
"toptier_code": "097",
"url": "https://www.usaspending.gov/agency/department-of-defense",
"website": "https://www.defense.gov/"
}Get agency budget
Get an agency's budgetary resources, obligations and outlays for a fiscal year, its share of the government's total, and the same figures for every year since 2017.
Inputs
- Agency
agencytextRequired - The federal agency. Pick one, or use an agency code from List agencies, such as 097 for the Department of Defense.
- Fiscal year
fiscal_yeartext - The federal fiscal year, which runs October to September. Leave empty for the latest year with published data.One of:
2027(FY 2027 (Oct 2026 to Sep 2027)),2026(FY 2026 (Oct 2025 to Sep 2026)),2025(FY 2025 (Oct 2024 to Sep 2025)),2024(FY 2024 (Oct 2023 to Sep 2024)),2023(FY 2023 (Oct 2022 to Sep 2023)),2022(FY 2022 (Oct 2021 to Sep 2022)),2021(FY 2021 (Oct 2020 to Sep 2021)),2020(FY 2020 (Oct 2019 to Sep 2020)),2019(FY 2019 (Oct 2018 to Sep 2019)),2018(FY 2018 (Oct 2017 to Sep 2018)),2017(FY 2017 (Oct 2016 to Sep 2017)).
Outputs
budgetary_resourcesnumber- Total budgetary resources
fiscal_yearnumber- The fiscal year
government_budgetary_resourcesnumber- The whole government's budgetary resources
nametext- Name
obligatednumber- Dollars obligated
obligations_by_periodlist- Obligations through the year
outlaysnumber- Dollars paid out
percent_of_governmentnumber- The agency's share, in percent
toptier_codetext- The agency's code
yearslist- Every year with figures, newest first
Example output
{
"budgetary_resources": 2213230963902.27,
"fiscal_year": 2025,
"government_budgetary_resources": 13263700405307.76,
"name": "Department of Defense",
"obligated": 1451320548889.53,
"obligations_by_period": [
{
"obligated": 1451320548889.53,
"period": 12
}
],
"outlays": 1342207853342.79,
"percent_of_government": 16.6864,
"toptier_code": "097",
"years": [
{
"budgetary_resources": 2213230963902.27,
"fiscal_year": 2025,
"obligated": 1451320548889.53,
"outlays": 1342207853342.79
}
]
}Get award
Get one award's details: amounts, dates, agencies, recipient, place of performance, industry or program, and its usaspending.gov page.
Inputs
- Award
award_idtextRequired - The award_id from Search awards, such as CONT_AWD_W91ZLK21F0094_9700_W52P1J18DA057_9700. A link to the award's usaspending.gov page works too.
Outputs
amountnumber- Dollars obligated; for a loan, its face value
assistance_listingtext- Assistance listing (CFDA) number
assistance_listing_titletext- The assistance program's name
award_idtext- USAspending's ID for the award
award_numbertext- The agency's own number for the award
award_typetext- The kind of award
awarding_agencytext- The agency that made the award
awarding_agency_codetext- That agency's code, for the agency actions
awarding_officetext- The office that made it
awarding_sub_agencytext- The part of the agency that made it
business_categorieslist- How the recipient is classified, such as Small Business
categorytext- contract, idv, grant, loans, direct payment or other
competitiontext- How the contract was competed, for contracts
descriptiontext- What the award is for
end_datetext- When the work is due to end
funding_agencytext- The agency paying for it
funding_sub_agencytext- The part of that agency paying for it
last_modified_datetext- When it last changed
loan_subsidy_costnumber- A loan's cost to the government
naics_codetext- Industry code (NAICS), for contracts
naics_descriptiontext- What the industry code means
offers_receivednumber- How many offers the contract received
outlaysnumber- Dollars paid out so far
parent_award_idtext- For an order under a contract vehicle, the vehicle's award ID
parent_recipient_nametext- The recipient's parent company, if any
place_of_performancetext- Where the work is done
place_of_performance_statetext- State where the work is done
potential_valuenumber- A contract's value if every option is used (empty for grants)
pricingtext- How the contract is priced, such as FIRM FIXED PRICE
psc_codetext- Product or service code (PSC), for contracts
psc_descriptiontext- What the product or service code means
recipient_idtext- USAspending's ID for the recipient
recipient_locationtext- Where the recipient is based
recipient_nametext- Who received it
recipient_ueitext- The recipient's Unique Entity ID (UEI)
signed_datetext- When it was signed
start_datetext- When the work starts
subaward_amountnumber- Dollars passed on in sub-awards
subaward_countnumber- How many sub-awards have been reported
urltext- The award's page on usaspending.gov
Example output
{
"amount": 26700180.32,
"assistance_listing": null,
"assistance_listing_title": null,
"award_id": "CONT_AWD_W91ZLK21F0094_9700_W52P1J18DA057_9700",
"award_number": "W91ZLK21F0094",
"award_type": "DELIVERY ORDER",
"awarding_agency": "Department of Defense",
"awarding_agency_code": "097",
"awarding_office": "W6QK ACC-APG DIR",
"awarding_sub_agency": "Department of the Army",
"business_categories": [
"Small Business",
"Woman Owned Business"
],
"category": "contract",
"competition": "FULL AND OPEN COMPETITION",
"description": "ACQUISITION OF INFORMATION TECHNOLOGY TECHNICAL, STAFF, CYBERSECURITY SERVICE SUPPORT FOR DEVCOM CBC G6 ABERDEEN PROVING GROUND, MD.",
"end_date": "2026-06-16",
"funding_agency": "Department of Defense",
"funding_sub_agency": "Department of the Army",
"last_modified_date": "2026-07-09",
"loan_subsidy_cost": null,
"naics_code": "541519",
"naics_description": "Other Computer Related Services",
"offers_received": 6,
"outlays": 111302.98,
"parent_award_id": "CONT_IDV_W52P1J18DA057_9700",
"parent_recipient_name": "SOFT TECH CONSULTING, INC.",
"place_of_performance": "GUNPOWDER, MD, UNITED STATES",
"place_of_performance_state": "MD",
"potential_value": 44521739.94,
"pricing": "FIRM FIXED PRICE",
"psc_code": "DF01",
"psc_description": "IT AND TELECOM - IT MANAGEMENT SUPPORT SERVICES (LABOR)",
"recipient_id": "8651becb-bc7e-7f4b-9b39-928f8a38ce66-C",
"recipient_location": "CHANTILLY, VA, UNITED STATES",
"recipient_name": "SOFT TECH CONSULTING, INC.",
"recipient_uei": "NNQZAS2TE6S5",
"signed_date": "2021-06-04",
"start_date": "2021-06-17",
"subaward_amount": null,
"subaward_count": 0,
"url": "https://www.usaspending.gov/award/CONT_AWD_W91ZLK21F0094_9700_W52P1J18DA057_9700"
}Get COVID-19 or infrastructure spending
Get how much Congress provided for COVID-19 relief or the Infrastructure Investment and Jobs Act, how much has been obligated and spent, and the funding from each law.
Inputs
- Program
programtext - Which spending to report.One of:
covid_19(COVID-19),infrastructure(Infrastructure Investment and Jobs Act). Default:covid_19.
Outputs
award_obligatednumber- Of which obligated through awards
award_outlaysnumber- Of which paid out through awards
fundinglist- Funding by law, largest first
programtext- covid_19 or infrastructure
program_nametext- The program's name
total_budget_authoritynumber- Funding Congress provided
total_obligatednumber- Dollars obligated
total_outlaysnumber- Dollars paid out
Example output
{
"award_obligated": 567476106746.35,
"award_outlays": 304341858851.41,
"funding": [
{
"amount": 440740983451.74,
"code": "Z",
"law": "Infrastructure Investment and Jobs Act",
"public_law": "Emergency P.L. 117-58"
},
{
"amount": 366990613419.18,
"code": "1",
"law": "Infrastructure Investment and Jobs Act",
"public_law": "Non-emergency P.L. 117-58"
}
],
"program": "infrastructure",
"program_name": "Infrastructure Investment and Jobs Act",
"total_budget_authority": 807731596870.92,
"total_obligated": 607509194384.14,
"total_outlays": 330553807346.13
}Get federal account
Get a federal account's budgetary resources, obligations and outlays for a fiscal year, and the Treasury accounts under it.
Inputs
- Account number
account_numbertextRequired - The account_number from Search federal accounts, such as 075-0512.
- Fiscal year
fiscal_yeartext - The federal fiscal year, which runs October to September. Leave empty for the latest year with published data.One of:
2027(FY 2027 (Oct 2026 to Sep 2027)),2026(FY 2026 (Oct 2025 to Sep 2026)),2025(FY 2025 (Oct 2024 to Sep 2025)),2024(FY 2024 (Oct 2023 to Sep 2024)),2023(FY 2023 (Oct 2022 to Sep 2023)),2022(FY 2022 (Oct 2021 to Sep 2022)),2021(FY 2021 (Oct 2020 to Sep 2021)),2020(FY 2020 (Oct 2019 to Sep 2020)),2019(FY 2019 (Oct 2018 to Sep 2019)),2018(FY 2018 (Oct 2017 to Sep 2018)),2017(FY 2017 (Oct 2016 to Sep 2017)).
Outputs
account_numbertext- Account number
agency_codetext- The agency code in the account number
budgetary_resourcesnumber- Budgetary resources
bureau_nametext- The bureau within it
fiscal_yearnumber- The fiscal year
main_account_codetext- The main account code
nametext- Name
obligatednumber- Dollars obligated
outlaysnumber- Dollars paid out
parent_agency_codetext- The managing agency's code
parent_agency_nametext- The managing agency
treasury_accountslist- The Treasury accounts under it that year
urltext- Its page on usaspending.gov
Example output
{
"account_number": "075-0580",
"agency_code": "075",
"budgetary_resources": 827526213540.02,
"bureau_name": "Centers for Medicare and Medicaid Services",
"fiscal_year": 2026,
"main_account_code": "0580",
"name": "Payments to Health Care Trust Funds, Centers for Medicare and Medicaid Services, Health and Human Services",
"obligated": 568063890135.8,
"outlays": 589986151002.13,
"parent_agency_code": "075",
"parent_agency_name": "Department of Health and Human Services",
"treasury_accounts": [
{
"budgetary_resources": 788975649581.0,
"code": "075-2026/2026-0580-000",
"name": "Payments to Health Care Trust Funds, Centers for Medicare and Medicaid Services, Health and Human Services",
"obligated": 567945060744.4,
"outlays": 561009730802.12
}
],
"url": "https://www.usaspending.gov/federal_account/075-0580"
}Get last updated date
Get the day USAspending last updated its award data, to check for new data before running a search.
Inputs
None.
Outputs
last_updatedtext- The day award data was last updated (YYYY-MM-DD)
Example output
{
"last_updated": "2026-10-15"
}Get recipient
Get a recipient's profile: UEI, parent company, address, business types and what it received over a period.
Inputs
- Recipient
recipient_idtextRequired - The recipient_id from Search recipients or Search awards, such as b97d19b0-833c-8d8f-3a2c-157d04ea55ef-P.
- Period
periodtext - The time the totals cover.One of:
latest(Last 12 months),all(All time),2027(FY 2027 (Oct 2026 to Sep 2027)),2026(FY 2026 (Oct 2025 to Sep 2026)),2025(FY 2025 (Oct 2024 to Sep 2025)),2024(FY 2024 (Oct 2023 to Sep 2024)),2023(FY 2023 (Oct 2022 to Sep 2023)),2022(FY 2022 (Oct 2021 to Sep 2022)),2021(FY 2021 (Oct 2020 to Sep 2021)),2020(FY 2020 (Oct 2019 to Sep 2020)), and 12 more. Default:latest.
Outputs
addresstext- Street address
alternate_nameslist- Other names it has used
business_typeslist- How it is classified
citytext- City
congressional_districttext- Congressional district
countrytext- Country
dunstext- Older DUNS number, if any
leveltext- parent, child or recipient
loan_face_valuenumber- Face value of loans in the period
loan_transaction_countnumber- Loan transactions in the period
nametext- Name
parent_idtext- The parent's ID
parent_nametext- Its parent company, if any
periodtext- latest (last 12 months), all, or a fiscal year
recipient_idtext- USAspending's ID
statetext- State (two letters)
total_amountnumber- Dollars received in the period
transaction_countnumber- Transactions in the period
ueitext- Unique Entity ID (UEI)
urltext- Its page on usaspending.gov
ziptext- ZIP code
Example output
{
"address": "6801 ROCKLEDGE DR",
"alternate_names": [
"COMPOSITE TECHNOLOGY INC."
],
"business_types": [
"Corporate entity not tax exempt"
],
"city": "BETHESDA",
"congressional_district": "08",
"country": "UNITED STATES",
"duns": "834951691",
"level": "parent",
"loan_face_value": 0.0,
"loan_transaction_count": 0,
"name": "LOCKHEED MARTIN CORP",
"parent_id": "b97d19b0-833c-8d8f-3a2c-157d04ea55ef-P",
"parent_name": "LOCKHEED MARTIN CORP",
"period": "2025",
"recipient_id": "b97d19b0-833c-8d8f-3a2c-157d04ea55ef-P",
"state": "MD",
"total_amount": 65396393013.2,
"transaction_count": 32411,
"uei": "ZFN2JJXBLZT3",
"url": "https://www.usaspending.gov/recipient/b97d19b0-833c-8d8f-3a2c-157d04ea55ef-P/latest",
"zip": "20817"
}Get spending by state
Total federal award spending in each state and territory, with the amount per person, for the awards that match a search.
Inputs
- Award types
award_typeslist - Only these kinds of award. Leave all unticked for every kind.One or more of:
contracts,idvs(Contract vehicles (IDVs)),grants,direct_payments(Direct payments),loans,other(Other assistance). - Based on
locationtext - Which place counts for an award.One of:
place_of_performance(Where the work is done),recipient_location(Where the recipient is based). Default:place_of_performance. - Keywords
keywordslist - Words to look for in award descriptions and names, such as cybersecurity. Each needs at least 3 characters.
- From
start_datedate - Only spending on or after this day, back to 2007-10-01. Leave both dates empty for the last 12 months.
- To
end_datedate - Only spending on or before this day. Leave empty for today.
- Agency
agencytext - Only awards made by this agency.
- Sub-agency
sub_agencytext - Only awards made by this part of the agency, such as the Department of the Army. Pick an agency first to list its sub-agencies.
- Recipient
recipienttext - Only awards to this recipient: a name, such as Lockheed Martin, or a UEI.
- Industry codes (NAICS)
naics_codeslist - Only contracts in these industries, such as 541512. A shorter code covers everything under it (54 is professional services). Find codes with Look up codes.
- Product and service codes (PSC)
psc_codeslist - Only contracts for these products or services, such as 7030 for software. Find codes with Look up codes.
Outputs
based_ontext- place_of_performance (where work is done) or recipient_location
countnumber- How many states and territories
end_datetext- The last day searched (YYYY-MM-DD)
start_datetext- The first day searched (YYYY-MM-DD)
stateslist- Each state and territory, largest amount first
totalnumber- All of them together
Example output
{
"based_on": "place_of_performance",
"count": 2,
"end_date": "2026-10-15",
"start_date": "2025-10-15",
"states": [
{
"amount": 779827723.3,
"per_capita": 101.21,
"population": 7705281,
"state_code": "WA",
"state_name": "Washington"
},
{
"amount": 317386122.63,
"per_capita": 8.03,
"population": 39538223,
"state_code": "CA",
"state_name": "California"
}
],
"total": 1097213845.93
}Get spending over time
Total federal award spending by year, quarter or month, split by kind of award, for the awards that match a search.
Inputs
- Group by
group_bytext - How to split the time.One of:
fiscal_year(Fiscal year),quarter(Fiscal quarter),month,calendar_year(Calendar year). Default:fiscal_year. - Award types
award_typeslist - Only these kinds of award. Leave all unticked for every kind.One or more of:
contracts,idvs(Contract vehicles (IDVs)),grants,direct_payments(Direct payments),loans,other(Other assistance). - Keywords
keywordslist - Words to look for in award descriptions and names, such as cybersecurity. Each needs at least 3 characters.
- From
start_datedate - Only spending on or after this day, back to 2007-10-01. Leave both dates empty for the last 12 months.
- To
end_datedate - Only spending on or before this day. Leave empty for today.
- Agency
agencytext - Only awards made by this agency.
- Sub-agency
sub_agencytext - Only awards made by this part of the agency, such as the Department of the Army. Pick an agency first to list its sub-agencies.
- Recipient
recipienttext - Only awards to this recipient: a name, such as Lockheed Martin, or a UEI.
- Place of performance
statetext - Only awards for work done in this state or territory.One of:
AL(Alabama),AK(Alaska),AS(American Samoa),AZ(Arizona),AR(Arkansas),CA(California),CO(Colorado),CT(Connecticut),DE(Delaware),DC(District of Columbia), and 46 more. - Industry codes (NAICS)
naics_codeslist - Only contracts in these industries, such as 541512. A shorter code covers everything under it (54 is professional services). Find codes with Look up codes.
- Product and service codes (PSC)
psc_codeslist - Only contracts for these products or services, such as 7030 for software. Find codes with Look up codes.
Outputs
countnumber- How many periods
end_datetext- The last day searched (YYYY-MM-DD)
group_bytext- fiscal_year, quarter, month or calendar_year
periodslist- Each period, oldest first
start_datetext- The first day searched (YYYY-MM-DD)
totalnumber- All of them together
Example output
{
"count": 1,
"end_date": "2025-09-30",
"group_by": "quarter",
"periods": [
{
"amount": 24897683728.7,
"calendar_year": null,
"contracts": 10513660600.15,
"direct_payments": 39351077.0,
"fiscal_year": 2025,
"grants": 12481042447.83,
"idvs": 348365376.9,
"loans": 964423542.82,
"month": null,
"other": 550840684.0,
"period": "FY 2025 Q1",
"quarter": 1
}
],
"start_date": "2024-10-01",
"total": 24897683728.7
}Get state profile
Get the federal awards going to a state or territory: total amount, number of awards, amount per person, population and median household income.
Inputs
- State
statetextRequired - The state or territory.One of:
AL(Alabama),AK(Alaska),AS(American Samoa),AZ(Arizona),AR(Arkansas),CA(California),CO(Colorado),CT(Connecticut),DE(Delaware),DC(District of Columbia), and 46 more. - Period
periodtext - The fiscal year the totals cover, or all time. Leave empty for the latest year with published data.One of:
2027(FY 2027 (Oct 2026 to Sep 2027)),2026(FY 2026 (Oct 2025 to Sep 2026)),2025(FY 2025 (Oct 2024 to Sep 2025)),2024(FY 2024 (Oct 2023 to Sep 2024)),2023(FY 2023 (Oct 2022 to Sep 2023)),2022(FY 2022 (Oct 2021 to Sep 2022)),2021(FY 2021 (Oct 2020 to Sep 2021)),2020(FY 2020 (Oct 2019 to Sep 2020)),2019(FY 2019 (Oct 2018 to Sep 2019)),2018(FY 2018 (Oct 2017 to Sep 2018)), and 11 more.
Outputs
award_countnumber- How many awards
fipstext- FIPS code
income_yearnumber- The year of the income figure
loan_countnumber- How many loans
loan_face_valuenumber- Face value of loans
median_household_incomenumber- Median household income
nametext- Name
outlaysnumber- Dollars paid out
per_capitanumber- Dollars per person
periodtext- latest (last 12 months), all, or a fiscal year
populationnumber- Population
population_yearnumber- The year of the population figure
state_codetext- Two-letter code
total_awardednumber- Dollars awarded to recipients there
typetext- state, district or territory
Example output
{
"award_count": 579674,
"fips": "51",
"income_year": 2016,
"loan_count": 14865,
"loan_face_value": 8710164260.47,
"median_household_income": 68114.0,
"name": "Virginia",
"outlays": 112892224316.4,
"per_capita": 25286.63,
"period": "2025",
"population": 8470020,
"population_year": 2017,
"state_code": "VA",
"total_awarded": 214178247580.41,
"type": "state"
}Get top spending by category
Rank where the money went for the awards that match a search: top recipients, agencies, industries, products, programs, states, countries or federal accounts, largest first.
Inputs
- Break down by
categorytext - What to rank.One of:
recipient(Recipients),awarding_agency(Awarding agencies),awarding_subagency(Awarding sub-agencies),funding_agency(Funding agencies),naics(Industries (NAICS codes)),psc(Products and services (PSC codes)),cfda(Assistance programs (CFDA)),state_territory(States and territories),country(Countries),federal_account(Federal accounts). Default:recipient. - Award types
award_typeslist - Only these kinds of award. Leave all unticked for every kind.One or more of:
contracts,idvs(Contract vehicles (IDVs)),grants,direct_payments(Direct payments),loans,other(Other assistance). - Keywords
keywordslist - Words to look for in award descriptions and names, such as cybersecurity. Each needs at least 3 characters.
- From
start_datedate - Only spending on or after this day, back to 2007-10-01. Leave both dates empty for the last 12 months.
- To
end_datedate - Only spending on or before this day. Leave empty for today.
- Agency
agencytext - Only awards made by this agency.
- Sub-agency
sub_agencytext - Only awards made by this part of the agency, such as the Department of the Army. Pick an agency first to list its sub-agencies.
- Recipient
recipienttext - Only awards to this recipient: a name, such as Lockheed Martin, or a UEI.
- Place of performance
statetext - Only awards for work done in this state or territory.One of:
AL(Alabama),AK(Alaska),AS(American Samoa),AZ(Arizona),AR(Arkansas),CA(California),CO(Colorado),CT(Connecticut),DE(Delaware),DC(District of Columbia), and 46 more. - Industry codes (NAICS)
naics_codeslist - Only contracts in these industries, such as 541512. A shorter code covers everything under it (54 is professional services). Find codes with Look up codes.
- Product and service codes (PSC)
psc_codeslist - Only contracts for these products or services, such as 7030 for software. Find codes with Look up codes.
- Results per page
limitnumber - How many to return, up to 100.From 1 to 100. Default:
10. - Page
pagenumber - Which page of results. When has_more is true, ask for the next one.From 1 to 1000. Default:
1.
Outputs
categorytext- What the spending is broken down by
countnumber- How many came back on this page
end_datetext- The last day searched (YYYY-MM-DD)
has_moretrue/false- Whether there are more results; ask for the next page to get them
pagenumber- The page this is
resultslist- Largest amount first
start_datetext- The first day searched (YYYY-MM-DD)
Example output
{
"category": "recipient",
"count": 1,
"end_date": "2026-10-15",
"has_more": true,
"page": 1,
"results": [
{
"amount": 5490349279.92,
"code": "080961356",
"name": "TRIAD NATIONAL SECURITY, LLC",
"recipient_id": "59ab4d30-abec-ded6-33c4-5d9f37fd2da0-C",
"recipient_uei": "X7WUS5LRBQU3"
}
],
"start_date": "2025-10-15"
}List agencies
List every federal agency with its code, budget, obligations and share of the government's budget this fiscal year.
Inputs
- Sort by
sorttext - The order to list them in.One of:
name(Name, A to Z),budget(Largest budget first). Default:name.
Outputs
agencieslist- Every federal agency
countnumber- How many agencies
Example output
{
"agencies": [
{
"abbreviation": "DOD",
"budget_authority": 2617506434639.06,
"fiscal_year": 2026,
"name": "Department of Defense",
"obligated": 1468976620557.11,
"outlays": 1283091272160.17,
"percent_of_total_budget": 16.1762,
"slug": "department-of-defense",
"toptier_code": "097",
"url": "https://www.usaspending.gov/agency/department-of-defense"
}
],
"count": 1
}List award transactions
List the changes made to an award over time, such as new funding and modifications, newest first.
Inputs
- Award
award_idtextRequired - The award_id from Search awards, such as CONT_AWD_W91ZLK21F0094_9700_W52P1J18DA057_9700. A link to the award's usaspending.gov page works too.
- Results per page
limitnumber - How many to return, up to 100.From 1 to 100. Default:
10. - Page
pagenumber - Which page of results. When has_more is true, ask for the next one.From 1 to 1000. Default:
1.
Outputs
award_idtext- The award
countnumber- How many came back on this page
has_moretrue/false- Whether there are more results; ask for the next page to get them
pagenumber- The page this is
transactionslist- Its transactions, newest first
Example output
{
"award_id": "CONT_AWD_W91ZLK21F0094_9700_W52P1J18DA057_9700",
"count": 1,
"has_more": true,
"page": 1,
"transactions": [
{
"action_date": "2026-07-09",
"action_type": "FUNDING ONLY ACTION",
"amount": 10833.66,
"description": "ACQUISITION OF INFORMATION TECHNOLOGY TECHNICAL, STAFF, AND CYBER SECURITY SERVICE SUPPORT",
"id": "CONT_TX_9700_9700_W91ZLK21F0094_P00037_W52P1J18DA057_0",
"loan_face_value": 0.0,
"loan_subsidy_cost": 0.0,
"modification_number": "P00037"
}
]
}List sub-agencies
List an agency's sub-agencies and their offices, with what each obligated and how many new awards it made in a fiscal year.
Inputs
- Agency
agencytextRequired - The federal agency. Pick one, or use an agency code from List agencies, such as 097 for the Department of Defense.
- Fiscal year
fiscal_yeartext - The federal fiscal year, which runs October to September. Leave empty for the latest year with published data.One of:
2027(FY 2027 (Oct 2026 to Sep 2027)),2026(FY 2026 (Oct 2025 to Sep 2026)),2025(FY 2025 (Oct 2024 to Sep 2025)),2024(FY 2024 (Oct 2023 to Sep 2024)),2023(FY 2023 (Oct 2022 to Sep 2023)),2022(FY 2022 (Oct 2021 to Sep 2022)),2021(FY 2021 (Oct 2020 to Sep 2021)),2020(FY 2020 (Oct 2019 to Sep 2020)),2019(FY 2019 (Oct 2018 to Sep 2019)),2018(FY 2018 (Oct 2017 to Sep 2018)),2017(FY 2017 (Oct 2016 to Sep 2017)). - Results per page
limitnumber - How many to return, up to 100.From 1 to 100. Default:
10. - Page
pagenumber - Which page of results. When has_more is true, ask for the next one.From 1 to 1000. Default:
1.
Outputs
agency_nametext- The agency's name
countnumber- How many came back on this page
fiscal_yearnumber- The fiscal year
has_moretrue/false- Whether there are more results; ask for the next page to get them
pagenumber- The page this is
sub_agencieslist- Largest first
toptier_codetext- The agency's code
totalnumber- How many there are in all, across every page
Example output
{
"agency_name": "Department of Defense",
"count": 1,
"fiscal_year": 2026,
"has_more": true,
"page": 1,
"sub_agencies": [
{
"abbreviation": "USN",
"name": "Department of the Navy",
"new_award_count": 39851,
"obligations": 129125822440.7,
"offices": [
{
"code": "N00024",
"name": "NAVSEA HQ",
"new_award_count": 1027,
"obligations": 41931823643.27,
"transaction_count": 4558
}
],
"transaction_count": 139255
}
],
"toptier_code": "097",
"total": 25
}List sub-awards
List the sub-awards a recipient passed on from an award, such as subcontracts, as the recipient reported them.
Inputs
- Award
award_idtextRequired - The award_id from Search awards, such as CONT_AWD_W91ZLK21F0094_9700_W52P1J18DA057_9700. A link to the award's usaspending.gov page works too.
- Sort by
sorttext - Which sub-awards come first.One of:
amount(Largest amount first),date(Newest first). Default:amount. - Results per page
limitnumber - How many to return, up to 100.From 1 to 100. Default:
10. - Page
pagenumber - Which page of results. When has_more is true, ask for the next one.From 1 to 1000. Default:
1.
Outputs
award_idtext- The prime award
countnumber- How many came back on this page
has_moretrue/false- Whether there are more results; ask for the next page to get them
pagenumber- The page this is
subawardslist- Its sub-awards
Example output
{
"award_id": "CONT_AWD_FA862118F6251_9700_FA862115D6276_9700",
"count": 1,
"has_more": true,
"page": 1,
"subawards": [
{
"action_date": "2023-07-26",
"amount": 15485000.0,
"description": "AC-130J WST #12 COLA (DD250)",
"id": 2192073,
"recipient_name": "CAE USA INC.",
"subaward_number": "4105945330"
}
]
}Look up codes
Find industry (NAICS), product and service (PSC) or assistance listing (CFDA) codes by word or number, to use in the other actions' filters.
Inputs
- Code type
code_typetext - Which kind of code to look up.One of:
naics(Industry codes (NAICS)),psc(Product and service codes (PSC)),cfda(Assistance listings (CFDA)). Default:naics. - Search for
searchtextRequired - A word or the start of a code, such as software or 5415.
- Include retired codes
include_retiredtrue/false - Also list NAICS codes that are no longer used.Default:
false. - Results per page
limitnumber - How many to return, up to 100.From 1 to 100. Default:
10.
Outputs
code_typetext- naics, psc or cfda
codeslist- The codes found
countnumber- How many came back on this page
searchtext- What was searched for
Example output
{
"code_type": "naics",
"codes": [
{
"code": "513210",
"name": "Software Publishers",
"popular_name": null,
"retired_year": null
}
],
"count": 1,
"search": "software"
}Search awards
Find federal contracts, grants, loans and other awards by keyword, dates, agency, recipient, place or industry. Each result has an award_id for Get award.
Inputs
- Award type
award_typetext - The kind of award to search. One kind at a time.One of:
contracts,idvs(Contract vehicles (IDVs)),grants,direct_payments(Direct payments),loans,other(Other assistance). Default:contracts. - Keywords
keywordslist - Words to look for in award descriptions and names, such as cybersecurity. Each needs at least 3 characters.
- From
start_datedate - Only spending on or after this day, back to 2007-10-01. Leave both dates empty for the last 12 months.
- To
end_datedate - Only spending on or before this day. Leave empty for today.
- Agency
agencytext - Only awards made by this agency.
- Sub-agency
sub_agencytext - Only awards made by this part of the agency, such as the Department of the Army. Pick an agency first to list its sub-agencies.
- Recipient
recipienttext - Only awards to this recipient: a name, such as Lockheed Martin, or a UEI.
- Place of performance
statetext - Only awards for work done in this state or territory.One of:
AL(Alabama),AK(Alaska),AS(American Samoa),AZ(Arizona),AR(Arkansas),CA(California),CO(Colorado),CT(Connecticut),DE(Delaware),DC(District of Columbia), and 46 more. - Industry codes (NAICS)
naics_codeslist - Only contracts in these industries, such as 541512. A shorter code covers everything under it (54 is professional services). Find codes with Look up codes.
- Product and service codes (PSC)
psc_codeslist - Only contracts for these products or services, such as 7030 for software. Find codes with Look up codes.
- Sort by
sorttext - Which awards come first.One of:
amount(Largest amount first),signed(Newest first),updated(Recently updated first). Default:amount. - Results per page
limitnumber - How many to return, up to 100.From 1 to 100. Default:
10. - Page
pagenumber - Which page of results. When has_more is true, ask for the next one.From 1 to 1000. Default:
1.
Outputs
award_typetext- The award type searched
awardslist- The awards found
countnumber- How many came back on this page
end_datetext- The last day searched (YYYY-MM-DD)
has_moretrue/false- Whether there are more results; ask for the next page to get them
pagenumber- The page this is
start_datetext- The first day searched (YYYY-MM-DD)
Example output
{
"award_type": "contracts",
"awards": [
{
"amount": 26700180.32,
"assistance_listing": null,
"assistance_listing_title": null,
"award_id": "CONT_AWD_W91ZLK21F0094_9700_W52P1J18DA057_9700",
"award_number": "W91ZLK21F0094",
"award_type": "DELIVERY ORDER",
"awarding_agency": "Department of Defense",
"awarding_sub_agency": "Department of the Army",
"description": "ACQUISITION OF INFORMATION TECHNOLOGY TECHNICAL, STAFF, CYBERSECURITY SERVICE SUPPORT FOR DEVCOM CBC G6 ABERDEEN PROVING GROUND, MD.",
"end_date": "2026-06-16",
"last_modified_date": "2026-07-09",
"naics_code": "541519",
"naics_description": "OTHER COMPUTER RELATED SERVICES",
"outlays": 111302.98,
"place_of_performance_city": "GUNPOWDER",
"place_of_performance_country": "USA",
"place_of_performance_state": "MD",
"psc_code": "DF01",
"psc_description": "IT AND TELECOM - IT MANAGEMENT SUPPORT SERVICES (LABOR)",
"recipient_id": "8651becb-bc7e-7f4b-9b39-928f8a38ce66-C",
"recipient_name": "SOFT TECH CONSULTING, INC.",
"recipient_uei": "NNQZAS2TE6S5",
"signed_date": "2021-06-04",
"start_date": "2021-06-17",
"url": "https://www.usaspending.gov/award/CONT_AWD_W91ZLK21F0094_9700_W52P1J18DA057_9700"
}
],
"count": 1,
"end_date": "2025-09-30",
"has_more": true,
"page": 1,
"start_date": "2024-10-01"
}Search federal accounts
Find the accounts Congress funds agencies through, such as Grants to States for Medicaid, with each one's budget.
Inputs
- Keyword
keywordtext - Words in the account's name or number, such as medicare.
- Agency
agencytext - Only accounts this agency manages.
- Fiscal year
fiscal_yeartext - The federal fiscal year, which runs October to September. Leave empty for the latest year with published data.One of:
2027(FY 2027 (Oct 2026 to Sep 2027)),2026(FY 2026 (Oct 2025 to Sep 2026)),2025(FY 2025 (Oct 2024 to Sep 2025)),2024(FY 2024 (Oct 2023 to Sep 2024)),2023(FY 2023 (Oct 2022 to Sep 2023)),2022(FY 2022 (Oct 2021 to Sep 2022)),2021(FY 2021 (Oct 2020 to Sep 2021)),2020(FY 2020 (Oct 2019 to Sep 2020)),2019(FY 2019 (Oct 2018 to Sep 2019)),2018(FY 2018 (Oct 2017 to Sep 2018)),2017(FY 2017 (Oct 2016 to Sep 2017)). - Sort by
sorttext - Which accounts come first.One of:
budget(Largest budget first),name(Name, A to Z),number(Account number). Default:budget. - Results per page
limitnumber - How many to return, up to 100.From 1 to 100. Default:
10. - Page
pagenumber - Which page of results. When has_more is true, ask for the next one.From 1 to 1000. Default:
1.
Outputs
accountslist- The accounts found
countnumber- How many came back on this page
fiscal_yearnumber- The fiscal year of the budget figures
has_moretrue/false- Whether there are more results; ask for the next page to get them
pagenumber- The page this is
totalnumber- How many there are in all, across every page
Example output
{
"accounts": [
{
"account_number": "075-0512",
"agency_code": "075",
"budgetary_resources": 871639662892.66,
"managing_agency": "Department of Health and Human Services",
"managing_agency_abbreviation": "HHS",
"name": "Grants to States for Medicaid, Centers for Medicare and Medicaid Services, Health and Human Services",
"url": "https://www.usaspending.gov/federal_account/075-0512"
}
],
"count": 1,
"fiscal_year": 2026,
"has_more": true,
"page": 1,
"total": 22
}Search recipients
Find companies, nonprofits and governments that receive federal money, by name or UEI, with what each received in the last 12 months.
Inputs
- Name or UEI
keywordtext - The recipient's name, such as Lockheed Martin, or its UEI. Leave empty for the largest recipients.
- Award type
award_typetext - Only recipients of this kind of award.One of:
all(All award types),contracts,grants,loans. Default:all. - Sort by
sorttext - Which recipients come first.One of:
amount(Largest amount first),name(Name, A to Z). Default:amount. - Results per page
limitnumber - How many to return, up to 100.From 1 to 100. Default:
10. - Page
pagenumber - Which page of results. When has_more is true, ask for the next one.From 1 to 1000. Default:
1.
Outputs
countnumber- How many came back on this page
has_moretrue/false- Whether there are more results; ask for the next page to get them
pagenumber- The page this is
recipientslist- The recipients found
totalnumber- How many there are in all, across every page
Example output
{
"count": 1,
"has_more": true,
"page": 1,
"recipients": [
{
"amount": 48562608641.66,
"duns": "834951691",
"level": "parent",
"name": "LOCKHEED MARTIN CORP",
"recipient_id": "b97d19b0-833c-8d8f-3a2c-157d04ea55ef-P",
"uei": "ZFN2JJXBLZT3",
"url": "https://www.usaspending.gov/recipient/b97d19b0-833c-8d8f-3a2c-157d04ea55ef-P/latest"
}
],
"total": 287
}