# 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.

- Page: https://fous.com/methods/usaspending.gov/get-company-federal-awards
- Method: `usaspending.gov/get_company_federal_awards`, version 1
- Website: usaspending.gov
- Returns: recipient name, UEI, fiscal years, total obligated, award count, amounts by award type, top awarding agencies, recent awards
- Effect: read (it gets data and changes nothing)
- Sign-in: none needed
- Cost: 1 credit per completed run (1¢ with pay as you go); failed runs are free
- Verified: Nov 2, 2026

## Inputs

| Field | Type | Required | In the run below | Description |
|---|---|---|---|---|
| `recipient` | string | yes | `"Johns Hopkins University"` | Company or organization name, for example Lockheed Martin. |
| `award_type` | string | no | `"grants"` | Award category, for example grants; contracts include IDVs and other includes direct payments. One of "all", "contracts", "grants", "loans", "other". Default "all". |
| `max_recent` | integer | no | `3` | Maximum recent awards, for example 10. Default 10. |
| `fiscal_year` | string | no | `"2024"` | Federal fiscal year, for example 2025; use all for the last five complete fiscal years. Default "latest". |

## Output

From a run on Oct 23, 2026, shortened. Its input:

```json
{
  "recipient": "Johns Hopkins University",
  "award_type": "grants",
  "max_recent": 3,
  "fiscal_year": "2024"
}
```

Its output:

```json
{
  "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
}
```

## Run it

From code, with a Fous API key in `FOUS_API_KEY`; the answer's `data` holds the output:

```bash
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"}}'
```

From an AI agent connected to the Fous MCP server: its `run` with the same method and input. To connect one, give it `set up https://fous.com/SKILL.md`.

## 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.

## Input schema

```json
{
  "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

```json
{
  "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"
    }
  }
}
```

## See more

- [USAspending API: Search federal awards](https://fous.com/methods/usaspending.gov/search-federal-awards.md): Searches 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 API: Get agency spending](https://fous.com/methods/usaspending.gov/get-agency-spending.md): Gets a federal agency's fiscal-year budgetary resources, obligations, share of federal obligations, new award count, top recipients and spending classes from USAspending.
- [European Union API: Search EU contract awards](https://fous.com/methods/ted.europa.eu/search-contract-awards.md): Finds 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.
- [NIH API: Search grants](https://fous.com/methods/reporter.nih.gov/search-grants.md): Finds NIH research grants by topic, organisation, or researcher name. Searches the last five fiscal years by default.
- [Grants.gov API: Search grant opportunities](https://fous.com/methods/grants.gov/search-grants.md): Finds 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.
- [USAJOBS API: Search federal jobs](https://fous.com/methods/usajobs.gov/search-jobs.md): Searches 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.
- [SAM.gov API: Search contract opportunities](https://fous.com/methods/sam.gov/search-contract-opportunities.md): Finds active federal contract notices on SAM.gov that match keywords, agency, place of performance, set-aside, notice type and posting period.
- [SEC EDGAR API: Get company financials](https://fous.com/methods/sec.gov/get-company-financials.md): Looks 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.
- [All USAspending methods](https://fous.com/methods/usaspending.gov.md)
