# ForgeMesh Federal Award Search

> ForgeMesh Federal Award Search is a paid API for AI agents from x402.forgemesh.io, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Searches US federal contract award records by recipient name, with optional agency and date-range filters, returning structured award details from USAspending.gov

## Facts

- Endpoint: POST https://x402.forgemesh.io/federal-award-search
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/forgemesh-federal-award-search-7b10942e
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_3s2UryGnOskEsRq6YiKBG

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 forgemesh-federal-award-search-7b10942e -d '<json body>'
```

Example prompt: Can you pull up all federal contracts awarded to Palantir Technologies from the Department of Defense since January 2020, up to 10 results?

## When to prefer this

Choose this endpoint when you need structured, queryable federal contract award data tied to a specific recipient company, especially when you also want to filter by agency or date range. It is preferable to manually browsing USAspending.gov, as it returns machine-readable JSON with award IDs and direct links. Use it for vendor vetting, competitive intelligence on government revenue, or connecting policy events to contract winners. Not suitable for grant awards, state/local spending, or non-US procurement data.

## Known failure modes

- Recipient name shorter than 3 characters returns a validation error
- No matching awards found returns an empty awards array
- Invalid ISO date format for since/until causes a parsing error
- Limit exceeding 50 returns a validation error
- Misspelled agency name may return zero results without an explicit error
- Network timeout if USAspending.gov upstream is slow

## How this service works

US federal award search over official spending records: contract awards matching a recipient name, with agency attribution and award timelines. Use it to vet vendors, size a competitor's government business, or connect policy events to the companies winning the money. Supports agency and date-range filters.

## Output

Returns a JSON object containing the original query parameters, an array of matching award records (each with award ID, recipient name, award amount in USD, description, awarding agency and sub-agency, start and end dates, and a direct USAspending.gov URL), a count of returned records, and a data attribution string crediting USAspending.gov.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "maximum": 50,
   "minimum": 1
  },
  "since": {
   "type": "string",
   "description": "ISO start date (default: 2 years back)"
  },
  "until": {
   "type": "string",
   "description": "ISO end date (default: today)"
  },
  "agency": {
   "type": "string",
   "description": "awarding top-tier agency name, e.g. 'Department of Defense'"
  },
  "recipient": {
   "type": "string",
   "description": "company name, min 3 chars (required)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "query": {
   "recipient": "Palantir"
  },
  "awards": [
   {
    "award_id": "W56KGY18C0184",
    "end_date": "2026-03-08",
    "award_url": "https://www.usaspending.gov/award/CONT_AWD_...",
    "recipient": "PALANTIR TECHNOLOGIES INC.",
    "amount_usd": 823000000,
    "start_date": "2018-03-09",
    "description": "ARMY INTELLIGENCE DATA PLATFORM",
    "awarding_agency": "Department of Defense",
    "awarding_sub_agency": "Department of the Army"
   }
  ],
  "returned": 5,
  "attribution": "USAspending.gov (public domain)"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/forgemesh-federal-award-search-7b10942e/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402.forgemesh.io](https://www.zero.xyz/host/x402.forgemesh.io/llms.txt)