USAspending Federal Awards: Contracts, IDVs & Grants

What it does: returns US federal awards from the official USAspending.gov API (US Treasury): contracts, indefinite-delivery vehicles (GWACs, IDIQs, BPAs, FSS) and grants/cooperative agreements. Each award comes as one flat record with recipient, amount, outlays, awarding and funding agency, NAICS/PSC codes or assistance listing, start/end dates and a link to the award page. Filter by keyword, recipient, awarding agency, NAICS, PSC, assistance listing, place-of-performance state, amount range and date range.

Why use it: it calls the documented public API directly (no HTML scraping), handles the API's one-award-group-per-search rule for you, and costs $2 per 1,000 awards.

Use cases

• Track a competitor or partner. List the federal contracts and grants one company has received, by name or UEI.
• Size a market. Pull every award in a NAICS or PSC code, an agency or a state, and total the amounts.
• Find leads. Companies that just won a federal award often need subcontractors, staff and suppliers.
• Follow grant money. See which organisations receive funding under a given assistance listing.
• Feed other tools. Results are plain JSON records, so they drop into a spreadsheet, a BI tool or an AI agent.

Tutorial: How to find who is winning federal cybersecurity contracts (without writing API code)

Input

{
  "awardTypes": ["contracts", "idvs"],
  "daysBack": 30,
  "keywords": ["cybersecurity"],
  "agency": "Department of Defense",
  "naicsCodes": ["541512"],
  "states": ["VA"],
  "minAmount": 100000,
  "sortBy": "amount",
  "maxItems": 500
}

• awardTypes: contracts (definitive contracts, purchase orders, delivery orders, BPA calls), idvs (GWACs, IDIQs, BPAs, FSS) and/or grants (block, formula and project grants and cooperative agreements). Direct payments, loans and insurance are not offered, because they mostly go to individuals.
• daysBack (default 30) or dateFrom / dateTo (YYYY-MM-DD, from 2007-10-01). This is USAspending's time-period filter: awards with an action in the period.
• keywords: USAspending keyword search, at least 3 characters each.
• recipient: recipient name or UEI search text.
• agency: the exact top-tier awarding agency name, e.g. Department of Energy. A name that doesn't match returns no results.
• naicsCodes, pscCodes: contracts and IDVs only. assistanceListings (e.g. 93.778): grants only. Filters that don't apply to an award type are ignored for that type, and the log says so.
• states: place-of-performance state or territory codes.
• minAmount / maxAmount (USD), sortBy (amount, start_date or last_modified, all newest/largest first), maxItems (default 500; at most 10,000 per award type).

Output

One record per award. A real example (contract, NAICS 541512, Virginia, fetched 2026-10-09):

{
  "award_id": "47QFCA21F0001",
  "award_group": "contracts",
  "award_type": "DELIVERY ORDER",
  "recipient_name": "SCIENCE APPLICATIONS INTERNATIONAL CORPORATION",
  "recipient_uei": "MMLKPW9JLX64",
  "recipient_city": "RESTON",
  "recipient_state": "VA",
  "recipient_country": "UNITED STATES",
  "recipient_withheld": false,
  "amount": 1205937997.76,
  "total_outlays": -280276.75,
  "description": "THE SCOPE OF THE TO IS TO PROVIDE ENTERPRISE IT SERVICES FOR THE USACE.",
  "awarding_agency": "General Services Administration",
  "awarding_sub_agency": "Federal Acquisition Service",
  "funding_agency": "Department of Defense",
  "naics_code": "541512",
  "naics_description": "COMPUTER SYSTEMS DESIGN SERVICES",
  "psc_code": "DA01",
  "psc_description": "IT AND TELECOM - BUSINESS APPLICATION/APPLICATION DEVELOPMENT SUPPORT SERVICES (LABOR)",
  "assistance_listings": [],
  "start_date": "2020-11-30",
  "end_date": "2026-11-27",
  "last_date_to_order": null,
  "base_obligation_date": "2020-11-30",
  "last_modified": "2026-09-21 14:03:34",
  "place_of_performance_state": "VA",
  "place_of_performance_country": "USA",
  "url": "https://www.usaspending.gov/award/CONT_AWD_47QFCA21F0001_4732_47QTCK18D0001_4732",
  "fetched_at": "2026-10-09T18:38:37Z"
}

Field	Meaning
award_id, award_group, award_type	PIID/FAIN, the group you asked for, and the award type as USAspending names it
recipient_name, recipient_uei, recipient_city, recipient_state, recipient_country	The recipient (organisations only, see Limits)
recipient_withheld	true when the recipient may be an individual, so its name, UEI, city and state are left empty
amount, total_outlays	Award amount (obligations, or face value for IDVs) and outlays to date, USD
description	Award description (cut at 2,000 characters; emails and phone numbers replaced)
awarding_agency, awarding_sub_agency, funding_agency	Agencies
naics_code, naics_description, psc_code, psc_description	Contracts and IDVs
assistance_listings	Grants: assistance listing (CFDA) number and program title
start_date, end_date, last_date_to_order, base_obligation_date, last_modified	Dates (last_date_to_order for IDVs)
place_of_performance_state, place_of_performance_country	Where the work is done
url	The award page on USAspending.gov

FAQ

How do I get USAspending data without writing API code? Run the Actor with the filters you want. Results land in an Apify dataset, which you can download as JSON, CSV or Excel, or read through the Apify API.

How do I find the federal contracts a company has won? Set recipient to the company name or its UEI, set awardTypes to ["contracts", "idvs"], and widen daysBack (for example 365) or set dateFrom.

Why does my agency filter return nothing? agency must be the exact top-tier name in full, such as Department of Defense or General Services Administration. Abbreviations like DoD or GSA do not match.

What is an IDV? An indefinite-delivery vehicle: a contract such as a GWAC, IDIQ, BPA or Federal Supply Schedule that agencies place orders against later. Its amount is the vehicle's face value, and last_date_to_order is the last day orders can be placed.

Why is the recipient name empty on some awards? recipient_withheld is true when the recipient may be an individual, or when USAspending itself hides the name. The award page in url has the full record. See Limits.

Is this the same as SAM.gov contract opportunities? No. This Actor returns awards that have already been made, as reported on USAspending.gov. It does not return open solicitations.

How far back does it go? To 2007-10-01, the start of USAspending's award search.

Pricing

Pay per event:

• $0.005 per run (start).
• $0.002 per award returned, so $2 per 1,000 awards.

Set a maximum charge per run in Apify to cap spend.

Limits

• Recipients are named only when they are clearly organisations: a legal-entity word (Inc, LLC, Corp, Company, Ltd, LLP, PLLC, P.C. and similar), or a public or non-profit body (university, college, state/city/county, department, agency, government, institute, institution, foundation, association, hospital, tribe, center, fund...). Anyone else may be a sole proprietor, i.e. a person, so recipient_withheld is true and the name, UEI, city and state are left out. The award page (url) has the full record. In samples from September–October 2026, 4% of contracts, 4% of IDVs and 6% of the grants that USAspending itself names were withheld. Some real companies whose names carry no legal suffix are also withheld (e.g. "General Atomics"). Street addresses are never returned.
• USAspending itself hides recipients of grants to individuals as REDACTED DUE TO PII. Those records are returned with recipient_withheld: true. In one sample of 600 recent grants, 198 were like this.
• Assistance (grant) data is reported by agencies in batches, so the newest grants can appear days to weeks after the action date.
• USAspending's search covers actions from 2007-10-01. Up to 100 pages of 100 awards per award type per run.
• Data is US government work (public domain), from api.usaspending.gov. This Actor is not affiliated with or endorsed by the US Treasury or USAspending.gov.