Bosco Labs
US Federal Awards API: contracts & grants, all agencies
Coming soon to the StoreGet US federal contracts, grants and loans from every agency (USAspending.gov): who won, which agency paid, how much, when, for what (NAICS, PSC, assistance listing), where, plus the winner's parent company and US stock ticker. For sales intelligence, investors measuring government revenue exposure, and procurement or policy research.
Pricing (pay per event): $0.004 per award row ($4 per 1,000). Nothing is charged for an empty or failed run, and the Actor stops at your max charge limit.
Questions agents ask
- “Which federal contracts did Palantir win this quarter?”
- “Largest NASA contracts last month”
- “Grants to universities in Texas for AI this year”
Example
Input
{
"agencies": ["NASA"],
"awardTypes": ["contracts"],
"dateFrom": "2026-10-01",
"dateTo": "2026-10-31",
"maxResults": 20
}Output
{
"award_id": "NNM16AA02C",
"award_type_group": "contracts",
"award_type": "DEFINITIVE CONTRACT",
"recipient_name": "AEROJET ROCKETDYNE OF DE, INC",
"recipient_uei": "JCZYYYQ7JGF5",
"parent_name": "L3HARRIS TECHNOLOGIES, INC",
"ticker": "LHX",
"matched_on": "parent",
"awarding_agency": "National Aeronautics and Space Administration",
"action_date": "2026-10-29",
"action_amount_usd": 53422103.0,
"modification_number": "174",
"total_obligated_usd": 3438289825.36,
"total_value_usd": 4143466817.0,
"award_date_signed": "2015-11-19",
"end_date": "2029-09-30",
"description": "IGF::CT::IGF RS-25 PRODUCTION RESTART TO BE UNDERTAKEN BY THE CONTRACTOR IN SUPPORT OF PROVIDING SIX RS-25 ENGINES ...",
"naics_code": "541712",
"psc_code": "1675",
"psc_description": "SPACE VEHICLE COMPONENTS",
"performance_state": "CA",
"source_url": "https://www.usaspending.gov/award/CONT_AWD_NNM16AA02C_8000_-NONE-_-NONE-",
"schema_version": "1"
}What you get
| Field | Type | Meaning |
|---|---|---|
schema_version | string | Output schema version. |
award_id | string | null | Award identifier as USAspending shows it: contract PIID, or FAIN/URI for financial assistance. |
award_key | string | USAspending generated_internal_id: the unique award key, also used in source_url. |
award_type_group | string | null | contracts, grants, loans, direct_payments or other (from the USAspending award type code). |
award_type | string | null | Award type as USAspending describes it, e.g. DEFINITIVE CONTRACT, DELIVERY ORDER, PROJECT GRANT (B), COOPERATIVE AGREEMENT (B). |
award_type_code | string | null | USAspending award type code, e.g. D (definitive contract), C (delivery order), 04 (project grant), 05 (cooperative agreement), 07 (direct loan). |
parent_award_id | string | null | PIID of the parent IDV (IDIQ, BPA, GSA schedule) for task and delivery orders; null otherwise. |
recipient_name | string | null | Recipient (winner) name as published by USAspending. |
recipient_uei | string | null | Recipient's SAM.gov Unique Entity ID (12 characters). |
parent_name | string | null | Parent company of the recipient, from the USAspending award record. |
parent_uei | string | null | Parent company's UEI. |
recipient_city | string | null | Recipient's city. |
recipient_state | string | null | Recipient's US state code. |
recipient_country | string | null | Recipient's country. |
ticker | string | null | US stock ticker (NYSE/Nasdaq/CBOE) when the recipient or parent name exactly matches an SEC-listed company after cleaning; null otherwise. Derived by Bosco Labs, not by USAspending. |
matched_on | string | null | "recipient" or "parent": which name matched the ticker; null when no ticker. |
awarding_agency | string | null | Top-tier awarding agency, e.g. National Aeronautics and Space Administration. |
awarding_sub_agency | string | null | Awarding sub-agency, e.g. Department of the Navy, National Institutes of Health. |
funding_agency | string | null | Top-tier funding agency (can differ from the awarding agency). |
action_date | string | null | Date (YYYY-MM-DD) of the award's action shown in this row: its largest action in the date window (sortBy amount) or its latest (sortBy date). |
action_amount_usd | number | null | Federal obligation of that action in USD (negative = de-obligation; 0 for administrative modifications and loans). |
modification_number | string | null | Modification number of that action ("0" or empty = the base award). |
total_obligated_usd | number | null | Total obligated on the award so far, all actions since signing, in USD. |
total_value_usd | number | null | Contracts: potential total value including all options (base_and_all_options), USD. Loans: loan face value. Null for other assistance. |
award_date_signed | string | null | Date the award was first signed (base award), YYYY-MM-DD. Earlier than dateFrom = the row is a modification of an older award. |
start_date | string | null | Period of performance start, YYYY-MM-DD. |
end_date | string | null | Period of performance current end, YYYY-MM-DD. |
description | string | null | Award description, cut at 300 characters. |
naics_code | string | null | NAICS industry code (contracts). |
naics_description | string | null | NAICS industry title. |
psc_code | string | null | Product and Service Code (contracts). |
psc_description | string | null | Product and Service Code title. |
cfda_number | string | null | Assistance listing (CFDA) number (financial assistance), e.g. 47.070. |
cfda_title | string | null | Assistance listing title. |
performance_city | string | null | Place of performance city. |
performance_state | string | null | Place of performance US state code. |
performance_country | string | null | Place of performance country. |
source_url | string | The award's page on usaspending.gov (the source to cite). |
api_url | string | The award record in the USAspending API (JSON). |
retrieved_at | string | When this row was retrieved, ISO-8601 UTC. |
Use with AI agents (MCP)
Add this URL to your MCP client (Claude, Cursor, VS Code, ...) to load the Actor as a tool through the Apify hosted MCP server. It signs you in with OAuth or accepts Authorization: Bearer <APIFY_TOKEN>. It works once the Actor is live on the Apify Store.
https://mcp.apify.com?tools=bosco_labs/us-federal-awardsFor “Which federal contracts did Palantir win this quarter?” the agent passes:
{"tickers": ["PLTR"], "dateFrom": "2026-10-01"}Or call the Apify API: POST https://api.apify.com/v2/acts/bosco_labs~us-federal-awards/run-sync-get-dataset-items with the input as JSON body. Cost: $0.004 per award row.
Input fields
| Field | Type | Meaning |
|---|---|---|
recipients | array | Winning organisations, as name text or 12-character SAM UEI, e.g. ["palantir"], ["university of texas"] or ["FSY4LVSBGWB7"]. USAspending matches the text against recipient and parent company names and UEIs. Empty (default) = all recipients. |
tickers | array | Only awards whose recipient or its parent company matches these US-listed tickers (NYSE, Nasdaq, CBOE; exact cleaned SEC company name), e.g. ["PLTR"] or ["LMT", "BAH"]. Subsidiaries are found through their parent company. Empty (default) = no ticker filter; every row still gets a ticker when its name matches. |
agencies | array | Awarding agencies by abbreviation, name or toptier code, e.g. ["NASA"], ["Department of Energy"], ["097"] (DoD). A name that is not a top-tier agency is searched as a sub-agency, e.g. ["Defense Logistics Agency"]. Empty (default) = all federal agencies. |
awardTypes | array | Which awards: "contracts" (USAspending codes A-D: BPA calls, purchase orders, delivery orders, definitive contracts), "grants" (02-05: block, formula, project grants, cooperative agreements), "loans" (07, 08), "direct_payments" (06, 10), "other" (09, 11: insurance, other assistance). E.g. ["grants"]. Default ["contracts"]. |
keywords | array | Full-text search over award descriptions and other text fields, e.g. ["artificial intelligence"] or ["cybersecurity"]. Several keywords = any of them. Empty (default) = no keyword filter. |
naicsCodes | array | NAICS industry codes, 2 to 6 digits, e.g. ["541512"] (computer systems design) or ["3364"]. Contracts only. Empty (default) = all. |
pscCodes | array | Product and Service Codes, e.g. ["DA01"] (IT software development) or ["AR"] (space R&D). Contracts only. Empty (default) = all. |
cfdaNumbers | array | Assistance listing (CFDA) numbers as NN.NNN, e.g. ["47.070"] (NSF computer and information science) or ["93.855"] (NIH allergy and infectious diseases). Financial assistance only. Empty (default) = all. |
placeOfPerformanceStates | array | Two-letter US state or territory codes where the work is done, e.g. ["TX"] or ["VA", "MD", "DC"]. Empty (default) = anywhere, including abroad. |
dateFrom | string | Earliest action date (signing date of the award or of a modification), YYYY-MM-DD, e.g. "2026-07-01". Searchable from 2007-10-01. Empty (default) = 30 days before dateTo. DoD contracts appear up to 90 days late. |
dateTo | string | Latest action date, YYYY-MM-DD, e.g. "2026-09-30". Empty (default) = today. |
minAmount | integer | Only awards whose total obligated amount (all actions since signing) is at least this many US dollars, e.g. 1000000. Empty or 0 (default) = no minimum. |
sortBy | string | "amount" (default) = awards ordered by their largest action (obligation) in the date window, largest first; that action is the one shown. "date" = ordered by their latest action in the window, newest first. Loans-only searches rank by loan face value. |
maxResults | integer | Maximum award rows, one per award, e.g. 20. Default 20, maximum 1000. Each row is one charged event. |
Sources, licence and limits
One row per award or per transaction? Per award. An award (contract, grant, loan) gets many actions over its life: the base award and its modifications. A row shows the award's largest action in your window (action_amount_usd, action_date, modification_number) next to its lifetime totals. If award_date_signed is before your window, the row is a modification of an older award, not a new win.
How fresh is the data? Civilian agencies report within days. Department of Defense contract actions are published up to 90 days after signing (a DoD rule), so recent DoD windows are nearly empty; for same-evening DoD awards use our Pentagon / DoD Contract Awards Actor.
What does minAmount filter on? The award's total obligated amount, not the single action.
Why is an amount 0 or negative? Administrative modifications obligate $0, de-obligations are negative, and loan actions obligate $0 (the face value is in total_value_usd).
How does ticker matching work? The recipient name and its parent company (from the award record) are cleaned (lower case, no Inc/Corp/LLC/Holdings) and must exactly equal the cleaned name of a NYSE, Nasdaq or CBOE company in the SEC's ticker list. We would rather miss a match than give a wrong ticker: joint ventures, foreign parents, renamed subsidiaries and private companies stay null. It is not investment advice.
Are individuals included? No. USAspending redacts financial assistance to individuals ("REDACTED DUE TO PII") and groups small payments into county-level "MULTIPLE RECIPIENTS" records; we leave both out. Some contracts go to sole proprietors whose business name is a person's name; those are shown exactly as USAspending publishes them, with nothing added.
Why does a keyword match an award whose description lacks it? USAspending's keyword search covers more text fields than the description shown.
What is not included? Sub-awards, IDV vehicles themselves (their task orders are included), DUNS numbers, recipient street addresses and executive pay. Search history starts at 2007-10-01. A run scans at most 2,000 actions; narrow the filters for rare matches.
Legal basis? USAspending.gov data may be copied, redistributed and used commercially (see LEGAL.md in the source). Source: USAspending.gov, U.S. Department of the Treasury, Bureau of the Fiscal Service. Company names and locations may include data supplied by Dun & Bradstreet, Inc. (D&B); they are served per query, never as a bulk extract.