# US Brand Federal Award Snapshot

> US Brand Federal Award Snapshot is a paid API for AI agents from api.timzinin.com, paid per call via x402, $0.05/call, status unknown (last checked 2026-09-14).

Returns recent US federal contract/purchase-order awards for a named brand or company within a specified date window, sourced from USASpending.gov

## Facts

- Endpoint: POST https://api.timzinin.com/api/us-brand-federal-award-snapshot
- Price: $0.05/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/us-brand-federal-award-snapshot-bc47b1a2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_oilI-A6t-IG66Y4w46UPf

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 us-brand-federal-award-snapshot-bc47b1a2 -d '<json body>'
```

Example prompt: Can you pull the recent federal contract awards for Apple from July 1 to August 4, 2026? I want to see which government agencies awarded them contracts and for how much.

## When to prefer this

Choose this endpoint when you need a quick, structured snapshot of recent US federal procurement awards for a specific brand or company without building your own USASpending.gov integration. It is especially useful for competitive intelligence, vendor due diligence, grant/contract monitoring, or compliance reporting workflows where you need per-company award data on demand at low cost ($0.05/call). Prefer it over direct USASpending.gov API calls when you want a normalized, agent-friendly JSON response with attribution verification and source freshness metadata already resolved.

## Known failure modes

- Brand/company not found in USASpending.gov — 'found: false' with empty awards array
- No awards in the specified date window — result count of 0
- Partial results flag set to true if data retrieval was incomplete
- USASpending.gov upstream timeout causing increased run_ms or failed attempts
- Invalid UEI or brand name causing unresolvable recipient lookup
- Payment not settled — x402 payment flow fails before data is returned

## How this service works

Pay-per-call data & tool APIs

## Output

Returns a JSON object containing an array of federal award records for the queried brand, each including award ID, award type, action date, transaction amount, awarding agency, sub-agency, recipient UEI and name, modification number, and a generated internal ID. Also includes metadata such as total result count, query window, source freshness timestamp, attribution status, and processing stats (run time, item count, whether results are partial).

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "endDate": {
   "$ref": "#/definitions/bazaarShared0"
  },
  "requestId": {
   "type": "string",
   "pattern": "^[A-Za-z0-9._:-]+$",
   "maxLength": 80,
   "minLength": 1
  },
  "startDate": {
   "$ref": "#/definitions/bazaarShared0"
  },
  "maxResults": {
   "type": "integer",
   "maximum": 25,
   "minimum": 1
  },
  "recipientId": {
   "type": "string",
   "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}-C$"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "meta": {
   "run_ms": 1200,
   "settled": true,
   "item_count": 1
  },
  "results": [
   {
    "actor": "us-brand-federal-award-snapshot",
    "found": true,
    "awards": [
     {
      "awardId": "19FR6326K0799",
      "awardType": "PURCHASE ORDER",
      "actionDate": "2026-07-30",
      "internalId": "360959545",
      "recipientId": "09c94e6e-003f-7a9a-a6a9-2305eb5b6025-C",
      "modification": "0",
      "recipientUei": "HJAKCN4NEU95",
      "recipientName": "APPLE INC",
      "awardingAgency": "Department of State",
      "awardingSubAgency": "Department of State",
      "transactionAmount": 15236.93,
      "generatedInternalId": "CONT_AWD_19FR6326K0799_1900_-NONE-_-NONE-"
     }
    ],
    "window": {
     "endDate": "2026-08-04",
     "startDate": "2026-07-01"
    },
    "partial": false,
    "queriedAt": "2026-08-05T08:31:38.839Z",
    "recipient": {
     "uei": "HJAKCN4NEU95",
     "name": "APPLE INC",
     "detailUrl": "https://api.usaspending.gov/api/v2/recipient/09c94e6e-003f-7a9a-a6a9-2305eb5b6025-C/",
     "recipientId": "09c94e6e-003f-7a9a-a6a9-2305eb5b6025-C",
     "recipientLevel": "C",
     "attributionStatus": "verified_by_exact_recipient_id_and_uei"
    },
    "requestId": "prefill-apple-contracts-2026-08",
    "sourceAsOf": "2026-08-05",
    "resultCount": 1,
    "sourceStats": {
     "attempts": 3,
     "operations": 3,
     "decodedBytes": 2036
    },
    "schemaVersion": "1.0",
    "sourceAsOfRaw": "08/05/2026",
    "deliveryIntent": {
     "event": "result-found",
     "businessRows": 1
    }
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/us-brand-federal-award-snapshot-bc47b1a2/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.timzinin.com](https://www.zero.xyz/host/api.timzinin.com/llms.txt)