# US federal contract awards by recipient, industry or place

> Find federal contract awards by recipient name, NAICS industry code or state and fiscal year, from USAspending.gov.

Status: working operation.

## What it is for

A firm deciding whether to pursue federal work, size a competitor's government business or find prime contractors to subcontract under needs the awards actually made, with amounts, agencies and industry codes. This queries USAspending's award search and returns the largest matching contract awards.

Business development staff at government contractors, subcontractors looking for primes, and analysts sizing a market segment's federal spend.

## What happens to a request

The call sends your filters to the USAspending.gov award search API and returns the matching contract awards (definitive contracts, purchase orders, delivery and task orders) sorted by amount, with the award identifier and a link to each award's public page. Nothing is estimated.

## What you get

A JSON answer with up to 25 awards: award ID, recipient, amount, awarding agency, start date, NAICS code and description, and the USAspending link.

## Scope and limits

United States federal agencies; recipients anywhere.

- Contract awards only; grants and loans are not included.
- Open solicitations are not covered (they are on SAM.gov, which needs a separate key).
- Amounts are obligations as reported to USAspending, not payments.

## Operation: GET /federal-awards/op/search

Up to 25 federal contract awards matching recipient, NAICS, state and fiscal year, sorted by amount.

Price: free within a daily budget.

- `recipient` (string): Recipient name text
- `naics` (string): NAICS code
- `state` (string): Place of performance state
- `fiscal_year` (integer): Federal fiscal year

```json
{
  "filters": {
    "recipient": "Booz Allen",
    "fiscal_year": 2026
  },
  "awards": [
    {
      "award_id": "36C10B21N10070021",
      "recipient": "BOOZ ALLEN HAMILTON INC",
      "amount": 1365285599.63,
      "agency": "Department of Veterans Affairs",
      "start_date": "2021-05-17",
      "naics": "541512",
      "naics_description": "COMPUTER SYSTEMS DESIGN SERVICES",
      "url": "https://www.usaspending.gov/award/CONT_AWD_36C10B21N10070021_3600_VA11816D1007_3600"
    }
  ],
  "source": "https://api.usaspending.gov/api/v2/search/spending_by_award/"
}
```

## Make a request

Call GET /federal-awards/op/search?recipient=...&naics=...&state=...&fiscal_year=... (free, within a daily budget). Or describe the government-market data you need that this does not cover.

POST https://services.forevenza.com/federal-awards/requests with JSON like:

```json
{
  "action": "retrieve",
  "need": "List Booz Allen Hamilton's largest federal contract awards in fiscal 2026.",
  "specifications": {
    "recipient": "Booz Allen Hamilton",
    "fiscal_years": "2026"
  }
}
```

Schema: https://services.forevenza.com/federal-awards/schema.json