# ForgeMesh Federal Contractor Profile Lookup

> ForgeMesh Federal Contractor Profile Lookup 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).

Resolves a company name to its official US government recipient records including legal name, UEI, recipient level, recent federal award totals, and a USAspending.gov profile link.

## Facts

- Endpoint: POST https://x402.forgemesh.io/federal-contractor-profile
- 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-contractor-profile-lookup-b277c2a2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_nUYuYR1Lyzav8o6fc2cOa

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-contractor-profile-lookup-b277c2a2 -d '<json body>'
```

Example prompt: Can you look up Booz Allen Hamilton's federal contractor profile and tell me their UEI, official legal name, what level they are (parent or child), and how much they've received in recent federal awards?

## When to prefer this

Choose this endpoint when you need to resolve a company name to its official US government contractor identity, UEI, or federal award totals using public USAspending.gov data. It is the right first step before querying individual contract awards. Prefer this over general business lookup APIs when the specific need is federal contracting data, UEI verification, or sizing a firm's government revenue.

## Known failure modes

- Company name under 3 characters returns a validation error
- No matching recipients found returns an empty recipients array
- Ambiguous company name may return many unrelated results if limit not set carefully
- Non-US companies or companies with no federal awards may return zero results
- Rate limiting or payment failure returns a 402 error

## How this service works

Federal contractor profile lookup: resolve a company name to its official US government recipient records — legal name, UEI identifier, parent/child level, recent federal award totals, and a canonical profile link. The first step before pulling a company's individual contract awards, and a quick way to size any firm's federal business in one call.

## Output

A JSON object containing the search query echo, total matched records, number returned, and an array of recipient objects each with: UEI identifier, official legal name, recipient ID, recipient level (P for parent, C for child, R for recipient), total recent federal award amount in USD, and a direct USAspending.gov profile URL. Attribution to USAspending.gov is included.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "limit": {
   "type": "integer",
   "maximum": 20,
   "minimum": 1
  },
  "company": {
   "type": "string",
   "description": "company name, min 3 chars (required)"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "query": {
   "company": "Lockheed"
  },
  "matched": 287,
  "returned": 3,
  "recipients": [
   {
    "uei": "ZFN2JJXBLZT3",
    "name": "LOCKHEED MARTIN CORPORATION",
    "profile_url": "https://www.usaspending.gov/recipient/b97d19b0-833c-8d8f-3a2c-157d04ea55ef-P/latest",
    "recipient_id": "b97d19b0-833c-8d8f-3a2c-157d04ea55ef-P",
    "recipient_level": "P",
    "total_recent_amount_usd": 40100000000
   }
  ],
  "attribution": "USAspending.gov (public domain)"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/forgemesh-federal-contractor-profile-lookup-b277c2a2/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)