# OneShot Agent API – Company Federal Awards Lookup

> OneShot Agent API – Company Federal Awards Lookup is a paid API for AI agents from win.oneshotagent.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-19).

Returns US federal contracts or grants awarded to a company, sourced from USASpending.gov, filtered by date range and sorted by award size.

## Facts

- Endpoint: POST https://win.oneshotagent.com/v1/tools/lookup/company-federal-awards?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-19
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/oneshot-agent-api-company-federal-awards-lookup-aa25c398
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_Qhbu-4Iv04gwrGiBavjSR

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability oneshot-agent-api-company-federal-awards-lookup-aa25c398 -d '<json body>'
```

Example prompt: Pull up the top 10 federal contracts awarded to Lockheed Martin Corporation since 2020 — I want to see the agency, award amounts, and what the contracts covered.

## When to prefer this

Use this endpoint when you need structured, paginated federal award data (contracts or grants) for a specific company, especially when you have the company's UEI for precise matching. Prefer this over general web search when you need machine-readable award amounts, dates, agency details, and product classifications without scraping USASpending.gov directly. Best for due diligence, competitive analysis, grant research, and compliance workflows.

## Known failure modes

- No awards found for the given recipient name or UEI — returns empty awards array
- Ambiguous recipient name matches multiple entities — may return awards for similarly named companies
- UEI not recognized — no results returned
- Date range predates 2007-10-01 — may return error or be clamped to minimum
- Limit out of range (below 1 or above 25) — may return validation error
- Network or upstream USASpending.gov unavailability — may return error or timeout

## How this service works

Look up the US federal contracts or grants a recipient holds, largest first.

## Output

Returns a JSON object with a list of federal awards (contracts or grants) including: award ID, awarding agency and sub-agency, award start and end dates, total award amount in USD, product/industry classification codes and labels, recipient name and UEI, and a link to the full award record on USASpending.gov. Also indicates whether more results exist beyond the returned limit.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "uei": {
   "type": "string",
   "description": "The recipient's Unique Entity Identifier. Preferred over a name. A UEI is 12 letters and digits."
  },
  "kind": {
   "enum": [
    "contracts",
    "grants"
   ],
   "type": "string",
   "description": "Which group of awards to list"
  },
  "limit": {
   "type": "integer",
   "description": "Most awards to return, largest first. From 1 to 25. Defaults to `10`."
  },
  "recipient": {
   "type": "string",
   "description": "Recipient name, for example LOCKHEED MARTIN CORPORATION. A text match: similarly named recipients are returned too. 3 to 120 characters."
  },
  "active_after": {
   "type": "string",
   "description": "Start of the period to search, not before 2007-10-01. Default: three years before active_before. Use YYYY-MM-DD."
  },
  "active_before": {
   "type": "string",
   "description": "End of the period to search. Default: today. Use YYYY-MM-DD."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "kind": "contracts",
  "awards": [
   {
    "url": "https://www.usaspending.gov/award/CONT_AWD_N0001917C0001_9700_-NONE-_-NONE-",
    "agency": "Department of Defense",
    "end_on": "2031-03-31",
    "product": "Aircraft, Fixed Wing",
    "award_id": "N0001917C0001",
    "industry": "Aircraft Manufacturing",
    "start_on": "2017-11-17",
    "amount_usd": 35135514910.2,
    "sub_agency": "Department of the Navy",
    "description": "F-35 lightning II aircraft",
    "product_code": "1510",
    "industry_code": "336411",
    "recipient_uei": "EXAMPLEUEI01",
    "recipient_name": "LOCKHEED MARTIN CORPORATION"
   }
  ],
  "has_more": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/oneshot-agent-api-company-federal-awards-lookup-aa25c398/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from win.oneshotagent.com](https://www.zero.xyz/host/win.oneshotagent.com/llms.txt)