# US federal contract awards by recipient, industry or place

> Find US federal contract actions (awards and modifications) by vendor name, NAICS industry code, place-of-performance state and fiscal year, from FPDS, the government's contract reporting system.

Plumbline: Know who you are dealing with. Runs instantly.

## 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 contracts actually awarded, with obligated amounts, agencies and industry codes. This searches the Federal Procurement Data System, where agencies report every contract action, and returns the matching actions.

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

## What happens next

The call sends your filters to the FPDS public ATOM feed and returns the matching contract actions ten at a time, in FPDS order: each award or modification with its contract number, signing date, vendor, agency, the amount it obligated, the contract's total obligated to date, the NAICS code, the place of performance and a link to the FPDS record. Without a fiscal year, it searches actions signed in the last twelve months. Nothing is estimated or summed.

## What you get

A JSON answer with up to ten contract actions and the start of the next page, each with its contract number (PIID), modification number, signed date, vendor, department and agency, obligated amount, total obligated on the contract, base and all options value, NAICS code and description, place-of-performance state, description and FPDS link.

## Scope

United States federal agencies; recipients anywhere.

- Contract actions only; grants and loans are not included.
- Open solicitations are not covered (they are on SAM.gov).
- Amounts are obligations as reported to FPDS, not payments; a modification can obligate a negative amount.

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

Up to ten federal contract actions matching vendor, NAICS, place-of-performance state and fiscal year, from FPDS, with the start of the next page.

Price: free within a daily allowance.

- `recipient` (string): Vendor name text, as reported to FPDS
- `naics` (string): NAICS code
- `state` (string): Place-of-performance state, two letters
- `fiscal_year` (integer): Federal fiscal year
- `start` (integer): Where the page starts: 0, 10, 20 and so on

```json
{
  "filters": {
    "recipient": "LOCKHEED MARTIN",
    "fiscal_year": 2025,
    "signed_between": [
      "2024/10/01",
      "2025/09/30"
    ]
  },
  "actions": [
    {
      "piid": "0001",
      "modification": "10",
      "signed_date": "2025-01-28",
      "vendor": "LOCKHEED MARTIN CORPORATION (3632)",
      "department": "DEPT OF DEFENSE",
      "agency": "DEFENSE CONTRACT MANAGEMENT AGENCY (DCMA)",
      "obligated_amount": -466098.9,
      "total_obligated_amount": 1964384.2,
      "base_and_all_options_value": -466098.9,
      "naics": "334419",
      "naics_description": "OTHER ELECTRONIC COMPONENT MANUFACTURING",
      "place_of_performance_state": "NY",
      "description": "UNDEFINITIZED ORDER",
      "url": "https://www.fpds.gov/ezsearch/search.do?s=FPDS&indexName=awardfull&templateName=1.5.3&q=0001+9700+"
    }
  ],
  "next_start": 10,
  "note": "Each item is one contract action as reported to FPDS (an award or a modification): obligated_amount is that action's, total_obligated_amount the contract's to date. Results come in FPDS order, not by amount.",
  "source": "https://www.fpds.gov/ezsearch/FEEDS/ATOM?FEEDNAME=PUBLIC&q=VENDOR_NAME%3A%22LOCKHEED%20MARTIN%22%20SIGNED_DATE%3A%5B2024%2F10%2F01%2C2025%2F09%2F30%5D&start=0"
}
```

## Send a requirement

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

POST https://plumbline.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://plumbline.forevenza.com/federal-awards/schema.json

## Who runs it, and what it costs

Plumbline. Operated by Tempered Technologies LLC, 8 The Green STE B, Dover, DE 19901. Privacy questions and deletion requests: privacy@forevenza.com.

Free to use within a daily allowance; sending a requirement is free.

Privacy notice: https://plumbline.forevenza.com/privacy/
