# USAspending Federal Contract Search

> USAspending Federal Contract Search is a paid API for AI agents from apiacre.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-14).

Search public USAspending prime federal procurement awards by recipient name, UEI, or DUNS, returning contract values, agencies, performance dates, descriptions, and official award links.

## Facts

- Endpoint: POST https://apiacre.com/v1/research/us-contract-search
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/usaspending-federal-contract-search-eca33dc1
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_viz4fh875RURG8EjGLbHS

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 usaspending-federal-contract-search-eca33dc1 -d '<json body>'
```

Example prompt: Search USAspending federal contract records for Booz Allen Hamilton — I want to see their recent prime award contracts, the agencies that hired them, contract values, and performance dates.

## When to prefer this

Use this endpoint when you need structured, machine-readable federal procurement data tied to a specific vendor or organization, and you want official USAspending award details including bounded contract values and agency attribution. Prefer this over manual USAspending.gov browsing when building automated research pipelines, vendor vetting workflows, or competitive intelligence tools. Best when you have a specific company name, UEI, or DUNS to query — not for broad spending category or program-level searches.

## Known failure modes

- No awards found for an unrecognized or misspelled recipient name
- Ambiguous company name matching multiple entities — results may span unintended organizations
- UEI or DUNS not found in USAspending database
- Rate limit or payment failure resulting in 402 or 429 response
- Partial results if the USAspending upstream API is throttled or unavailable
- Interpretation limits flag if queried entity has common name shared by many organizations

## How this service works

Search public USAspending prime federal procurement awards by recipient company or organization name, UEI, or legacy DUNS, returning bounded contract values, agencies, performance dates, descriptions, official award links, and explicit interpretation limits.

## Output

Returns a structured list of prime federal procurement awards from USAspending, each including bounded contract dollar values, awarding agency name, period of performance start and end dates, a plain-language description of the work, and a direct link to the official USAspending award page. Also includes explicit interpretation limits clarifying the scope and reliability of the results.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "end_date": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "null"
    }
   ]
  },
  "start_date": {
   "anyOf": [
    {
     "type": "string"
    },
    {
     "type": "null"
    }
   ]
  },
  "max_results": {
   "type": "integer"
  },
  "recipient_query": {
   "type": "string"
  },
  "maximum_award_amount": {
   "anyOf": [
    {
     "type": "integer"
    },
    {
     "type": "null"
    }
   ]
  },
  "minimum_award_amount": {
   "anyOf": [
    {
     "type": "integer"
    },
    {
     "type": "null"
    }
   ]
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "query": {
    "endDate": "2026-08-13",
    "startDate": "2024-01-01",
    "recipientQuery": "Palantir USG",
    "minimumAwardAmountUsd": 1000000,
    "recipientFieldsSearched": [
     "name",
     "UEI",
     "legacy DUNS"
    ]
   },
   "awards": [
    {
     "awardId": "W9128Z26FA001",
     "internalId": 355423040,
     "recipientUei": "HNN4F9JZWDY8",
     "recipientName": "PALANTIR USG INC",
     "awardAmountUsd": 545578476.94
    }
   ],
   "source": "https://api.usaspending.gov/api/v2/search/spending_by_award/",
   "hasMore": true,
   "disclaimer": "Public federal procurement evidence for research only; verify the official aw...",
   "limitations": [
    "Recipient search is fuzzy across names, UEIs, and legacy DUNS values; a resul...",
    "Award Amount is USAspending's current aggregate award value, not necessarily ...",
    "Results are prime contracts only, sorted by aggregate award amount, limited t..."
   ],
   "retrievedAt": "2026-08-13T07:00:00+00:00",
   "awardsSkipped": 0,
   "documentation": "https://github.com/fedspendingtransparency/usaspending-api/blob/master/usaspe...",
   "awardsReturned": 5,
   "sourceMessages": [
    "USAspending search dates are limited to records from 2007-10-01 onward."
   ],
   "resultsReceived": 5
  },
  "meta": {
   "cached": false,
   "sources": [],
   "warnings": [],
   "duration_ms": 42,
   "next_actions": [
    {
     "path": "/v1/research/lei-entity-search",
     "title": "GLEIF legal entity search",
     "method": "POST",
     "reason": "Resolve a selected contract recipient against official GLEIF legal-entity rec...",
     "service": "research.lei-entity-search"
    }
   ]
  },
  "service": "research.us-contract-search",
  "version": "1",
  "request_id": "018f1f54-7f38-7ba2-8dc3-5f90272d9f1a"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/usaspending-federal-contract-search-eca33dc1/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from apiacre.com](https://www.zero.xyz/host/apiacre.com/llms.txt)