USAspending API: Get company federal awards
Returns federal obligations and distinct awards for a company or organization, including its parent and child recipient records. Covers the selected fiscal year or the last five fiscal years.
Unofficial. Not affiliated with or endorsed by USAspending.
Inputs
Values from the run on Oct 23, 2026, shown under Output.
- Recipient, required
recipient Company or organization name, for example Lockheed Martin.
Johns Hopkins University
- Award Type optional
award_type Award category, for example grants; contracts include IDVs and other includes direct payments.
grants
One of
all,contracts,grants,loans,other. Defaultall.- Max Recent optional
max_recent Maximum recent awards, for example 10.
3
Whole number from 1 to 50. Default
10.- Fiscal Year optional
fiscal_year Federal fiscal year, for example 2025; use all for the last five complete fiscal years.
2024
Default
latest.
Input as JSON
{ "recipient": "Johns Hopkins University", "award_type": "grants", "max_recent": 3, "fiscal_year": "2024"}Output
{ "currency": "USD", "fiscal_years": [ 2024 ], "recent_awards": [ { "amount": 1500000, "award_id": "15PBJA24GK04069CVIP", "award_link": "https://www.usaspending.gov/award/ASST_NON_15PBJA24GK04069CVIP_015" , "award_type": "Cooperative Agreement (B)", "start_date": "2024-10-01", "description": "GUN VIOLENCE REMAINS A SIGNIFICANT PUBLIC HEALTH AND SAFETY CRISIS IN THE UNITED STATES, DISPROPORTIONATELY IMPACTING INDIVIDUALS FROM MARGINALIZED AND DISINVESTED NEIGHBORHOODS. COMMUNITY-BASED VIOLENCE INTERVENTION (CVI) PROGRAMS CAN AND DO REDUCE VIOLENCE, BUT MANY CVI PROGRAMS LACK THE TECHNICAL…", "awarding_agency": "Department of Justice" }, { "amount": 1750023, "award_id": "R56AG083478", "award_link": "https://www.usaspending.gov/award/ASST_NON_R56AG083478_075" , "award_type": "Project Grant (B)", "start_date": "2024-09-30", "description": "MULTI-SCALE MRI-BASED DIFFEOMORPHOMETRY OF PATHOLOGY AND MOLECULAR SIGNATURES ASSOCIATED WITH ENTORHINAL CORTEX ATROPHY IN ALZHEIMER'S DISEASE - UNDERSTANDING THE UNIQUE VULNERABILITY OF CERTAIN CELL POPULATIONS IN THE BRAIN TO ALZHEIMER'S DISEASE (AD) - A DEBILITATING, CHRONIC DISEASE AFFECTING 6.2…", "awarding_agency": "Department of Health and Human Services" }, { "amount": 842722, "award_id": "R01HG013137", "award_link": "https://www.usaspending.gov/award/ASST_NON_R01HG013137_075" , "award_type": "Project Grant (B)", "start_date": "2024-09-23", "description": "STATISTICAL METHODS FOR DATA INTEGRATION AND APPLICATIONS TO GENOME-WIDE ASSOCIATION STUDIES - ABSTRACT LARGE-SCALE EPIDEMIOLOGIC STUDIES, INCLUDING BIOBANKS AND GENOME-WIDE ASSOCIATION STUDIES (GWAS), ARE NOW RAPIDLY LEADING TO THE IDENTIFICATION OF NOVEL RISK FACTORS FOR COMPLEX DISEASES. THERE IS…", "awarding_agency": "Department of Health and Human Services" } ], "recipient_uei": "FTMTDMBR29C7", "recipient_name": "THE JOHNS HOPKINS UNIVERSITY", "number_of_awards": 3303, "amounts_by_award_type": { "loans": 0, "other": 0, "grants": 1183122200.63, "contracts": 0 }, "top_awarding_agencies": [ { "agency": "Department of Health and Human Services", "amount": 898776674.98 }, { "agency": "Agency for International Development", "amount": 85783453 }, { "agency": "Department of Defense", "amount": 77505708.84 } ], "total_obligated_amount": 1183122200.63}Code
curl https://api.fous.com/v1/runs \ -H "Authorization: Bearer $FOUS_API_KEY" \ -H "Content-Type: application/json" \ -d '{"method":"usaspending.gov/get_company_federal_awards","input":{"recipient":"Johns Hopkins University","award_type":"grants","max_recent":3,"fiscal_year":"2024"}}' # Save as fous.py, then run: python3 fous.pyimport json, os, timefrom urllib.error import HTTPErrorfrom urllib.request import Request, urlopenAPI = "https://api.fous.com/v1/runs" KEY = os.environ["FOUS_API_KEY"]HEADERS = { "Authorization": f"Bearer {KEY}", "Content-Type": "application/json" ,}def call(url, body=None): data = json.dumps(body).encode() if body else None request = Request(url, data, HEADERS) try: with urlopen(request, timeout=120) as r: return r.status, json.load(r) except HTTPError as error: message = json.load(error)["error"]["message"] raise RuntimeError(message) from errorstatus, run = call(API, { "method": "usaspending.gov/get_company_federal_awards" , "input": { "recipient": "Johns Hopkins University", "award_type": "grants", "max_recent": 3, "fiscal_year": "2024" }})# 202: still going after 30 s. Ask again until it ends.while status == 202: time.sleep(2) status, run = call(f"{API}/{run['id']}")print(json.dumps(run["data"], indent=2))// Save as fous.mjs, then run: node fous.mjsconst api = "https://api.fous.com/v1/runs" ;const headers = { Authorization: `Bearer ${process.env.FOUS_API_KEY}`, "Content-Type": "application/json" ,};let response = await fetch(api, { method: "POST", headers, body: JSON.stringify({ "method": "usaspending.gov/get_company_federal_awards" , "input": { "recipient": "Johns Hopkins University", "award_type": "grants", "max_recent": 3, "fiscal_year": "2024" } }), signal: AbortSignal.timeout(120_000),});let run = await response.json();// 202: still going after 30 s. Ask again until it ends.while (response.status === 202) { await new Promise((done) => setTimeout(done, 2_000)); response = await fetch(`${api}/${run.id}`, { headers }); run = await response.json();}if (!response.ok) throw new Error(run.error.message);console.log(run.data);# Connect your agent to Fous once, over MCP (Streamable HTTP):# https://api.fous.com/mcp# Set FOUS_API_KEY first: create a key at https://app.fous.com/keys.# Claude Codeclaude mcp add \ --scope user \ --transport http fous https://api.fous.com/mcp \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Codexcodex mcp add fous \ --url https://api.fous.com/mcp \ --bearer-token-env-var FOUS_API_KEY# Cursor, VS Code, Windsurf, Cline and morenpx -y add-mcp https://api.fous.com/mcp -g -n fous \ --header "Authorization: Bearer ${FOUS_API_KEY:?Set FOUS_API_KEY to your Fous API key}"# Then ask your agent:# "Use Fous to run usaspending.gov/get_company_federal_awards# with {"recipient":"Johns Hopkins University","award_type":"grants","max_recent":3,"fiscal_year":"2024"}"Over HTTP, the answer’s data holds the output. A run still going after 30 seconds answers 202 with its id: ask GET /v1/runs/{id} until it ends.
Schema
Input schema
{ "type": "object", "required": [ "recipient" ], "properties": { "recipient": { "type": "string", "description": "Company or organization name, for example Lockheed Martin." }, "award_type": { "enum": [ "all", "contracts", "grants", "loans", "other" ], "type": "string", "default": "all", "description": "Award category, for example grants; contracts include IDVs and other includes direct payments." }, "max_recent": { "type": "integer", "default": 10, "maximum": 50, "minimum": 1, "description": "Maximum recent awards, for example 10." }, "fiscal_year": { "type": "string", "default": "latest", "description": "Federal fiscal year, for example 2025; use all for the last five complete fiscal years." } }}Output schema
{ "type": "object", "required": [ "recipient_name", "recipient_uei", "fiscal_years", "currency", "total_obligated_amount", "number_of_awards", "amounts_by_award_type", "top_awarding_agencies", "recent_awards" ], "properties": { "currency": { "type": "string" }, "fiscal_years": { "type": "array", "items": { "type": "integer" } }, "recent_awards": { "type": "array", "items": { "type": "object", "properties": { "amount": { "type": "number" }, "award_id": { "type": [ "string", "null" ] }, "award_link": { "type": "string" }, "award_type": { "type": "string" }, "start_date": { "type": [ "string", "null" ] }, "description": { "type": [ "string", "null" ] }, "awarding_agency": { "type": [ "string", "null" ] } } } }, "recipient_uei": { "type": [ "string", "null" ] }, "recipient_name": { "type": "string" }, "number_of_awards": { "type": "integer" }, "amounts_by_award_type": { "type": "object", "properties": { "loans": { "type": "number" }, "other": { "type": "number" }, "grants": { "type": "number" }, "contracts": { "type": "number" } } }, "top_awarding_agencies": { "type": "array", "items": { "type": "object", "properties": { "agency": { "type": "string" }, "amount": { "type": "number" } } } }, "total_obligated_amount": { "type": "number" } }}- Price
- 1 credit per completed run (1¢ with pay as you go); failed runs are free.
- Method
usaspending.gov/get_company_federal_awards- Returns
- recipient name, UEI, fiscal years, total obligated, award count, amounts by award type, top awarding agencies, recent awards
Use it from your agent
Give your agent this line. It reads SKILL.md, gets a Fous API key and connects the Fous MCP server. Its run then takes the method usaspending.gov/get_company_federal_awards with the inputs above.
Ask your agent
- How much federal money has Lockheed Martin obligated in fiscal year 2025, and how many awards does it hold?
- Show me the total federal grant dollars awarded to Mayo Clinic over the last five fiscal years on usaspending.gov.
- What are the top federal agencies awarding contracts to Booz Allen Hamilton, and what are its most recent awards?
- Give me a breakdown of loans and other direct payments received by Habitat for Humanity International across all fiscal years.
- List the 10 most recent federal contracts won by Accenture Federal Services in fiscal 2024, with its UEI and total obligated amount.
See more
All USAspending methodsSearches USAspending federal awards by keywords, awarding agency, state of performance and date across contracts, grants, loans and direct payments. Searches from October 1, 2007 onward.
usaspending.gov/search_federal_awardsGets a federal agency's fiscal-year budgetary resources, obligations, share of federal obligations, new award count, top recipients and spending classes from USAspending.
usaspending.gov/get_agency_spendingFinds published EU contract award notices on Tenders Electronic Daily by contract topic or winning company, newest publication first, optionally limited to a buyer country and a start date. Values and tender counts are included when published; counts across lots are summed.
ted.europa.eu/search_contract_awardsFinds NIH research grants by topic, organisation, or researcher name. Searches the last five fiscal years by default.
reporter.nih.gov/search_grantsFinds U.S. federal grant opportunities by topic, agency, applicant type and status, with funding and eligibility details. Open results exclude opportunities whose closing date has passed.
grants.gov/search_grantsSearches USAJOBS federal jobs by keywords, location, salary threshold and applicant group, in website relevance order. Salary ranges may start below the threshold; annual pay or remote status is null when the announcement does not state it.
usajobs.gov/search_jobsFinds active federal contract notices on SAM.gov that match keywords, agency, place of performance, set-aside, notice type and posting period.
sam.gov/search_contract_opportunitiesLooks up a public company by name or ticker on SEC EDGAR and returns its reported annual or quarterly financial figures from XBRL company facts. Quarterly flows are derived from year-to-date totals when no quarterly figure is filed. Unavailable figures are null.
sec.gov/get_company_financials