# Federal Contractor Spending Profile (USASpending.gov)

> Federal Contractor Spending Profile (USASpending.gov) is a paid API for AI agents from payai.agentstools.dev, paid per call via x402, $0.01/call, status unknown (last checked 2026-10-10).

Returns a comprehensive federal spending profile for a contractor by name or UEI, including total dollars, top agencies, top NAICS codes, fiscal-year trend, and recent awards.

## Facts

- Endpoint: GET https://payai.agentstools.dev/govcon/recipient?utm_source=zero.xyz
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-10
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/federal-contractor-spending-profile-usaspending-gov-933fe0c4
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_PaZkvmPn3Lb8vwS6Lfjmh

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 federal-contractor-spending-profile-usaspending-gov-933fe0c4
```

Example prompt: Pull a full federal spending profile for Booz Allen Hamilton — total dollars, top agencies, top NAICS codes, and a fiscal-year trend, filtering to contracts only for fiscal year 2023.

## When to prefer this

Use this endpoint when you need a comprehensive, pre-fused federal spending profile for a specific contractor in a single call, rather than manually querying USASpending.gov across multiple endpoints. It is ideal when you know the contractor name or UEI and want aggregated insights including agency breakdowns, NAICS codes, and year-over-year trends without assembling them yourself.

## Known failure modes

- Contractor name not found or ambiguous — may return empty results or require UEI for disambiguation
- Invalid or unknown UEI — returns error or empty profile
- Unsupported award_type enum value — schema validation error
- Fiscal year out of available range — returns empty trend data
- Rate limiting or upstream USASpending.gov unavailability — service error

## How this service works

Profile a federal contractor's spending footprint by name or UEI in one call: total federal dollars, top agencies, top NAICS, a fiscal-year trend and recent awards, fused from several USASpending.gov queries.

## Output

A structured spending profile including total federal dollars obligated, ranked list of top awarding agencies, top NAICS industry codes, a fiscal-year trend showing spending over time, and a list of recent awards — all fused from multiple USASpending.gov queries in a single response.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "$schema": "https://json-schema.org/draft/2020-12/schema",
 "required": [
  "input"
 ],
 "properties": {
  "input": {
   "type": "object",
   "required": [
    "type",
    "method"
   ],
   "properties": {
    "type": {
     "type": "string",
     "const": "http"
    },
    "method": {
     "enum": [
      "GET",
      "HEAD",
      "DELETE"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "uei": {
       "type": "string",
       "description": "Recipient UEI, if known"
      },
      "year": {
       "type": "integer",
       "description": "Federal fiscal year"
      },
      "recipient": {
       "type": "string",
       "description": "Contractor name"
      },
      "award_type": {
       "enum": [
        "contracts",
        "direct_payments",
        "grants",
        "idvs",
        "loans",
        "other"
       ],
       "type": "string"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/federal-contractor-spending-profile-usaspending-gov-933fe0c4/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from payai.agentstools.dev](https://www.zero.xyz/host/payai.agentstools.dev/llms.txt)