# x402-factory DHS Contract Awards Feed

> x402-factory DHS Contract Awards Feed is a paid API for AI agents from x402-factory.com, paid per call via x402, $0.02/call, status unknown (last checked 2026-09-13).

Returns the latest federal contract awards from the Department of Homeland Security, pre-filtered and sorted newest first, with recipient, value, NAICS code, and award dates.

## Facts

- Endpoint: GET https://x402-factory.com/v1/contracts/awards/dhs
- Price: $0.02/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-13
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/x402-factory-dhs-contract-awards-feed-10edc401
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_GDP33GTQ1omIuMVvowu5I

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 x402-factory-dhs-contract-awards-feed-10edc401
```

Example prompt: Pull the 20 most recent Department of Homeland Security contract awards since January 1, 2024, and filter for IT-related contracts using NAICS code 541512.

## When to prefer this

Choose this endpoint when you specifically need DHS-filtered contract data without having to add agency filters yourself. It is more targeted than the generic /v1/contracts/awards endpoint and saves query complexity. Prefer it over broader federal spending APIs when your use case is homeland security procurement monitoring, competitive intelligence on DHS vendors, or DHS budget analysis. The $0.02 per call cost makes it economical for frequent polling or monitoring workflows.

## Known failure modes

- No awards match the given filters — returns empty awards array
- Invalid NAICS format (not 2-6 digits) — schema validation error
- since date in wrong format or invalid calendar date — schema validation error
- limit out of range (below 1 or above 50) — schema validation error
- vendor string too short (under 2 chars) or too long (over 120 chars) — validation error
- USAspending upstream unavailable — potential 502 or timeout
- Payment not processed or insufficient funds — x402 payment required error

## How this service works

Latest Department of Homeland Security contract awards — Latest federal contract awards from Department of Homeland Security: recipient, value, NAICS, and award dates from USAspending, newest first. Same shape as /v1/contracts/awards, pre-filtered to Department of Homeland Security.

## Output

A JSON object containing an array of DHS contract award records, each with vendor name, agency, sub-agency, contract description, award value in USD, award date, NAICS code, and place of performance, plus a meta object with pagination or summary information. Results are sorted newest first, capped at the requested limit (default 20, max 50).

## 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"
     ],
     "type": "string"
    },
    "queryParams": {
     "type": "object",
     "required": [],
     "properties": {
      "limit": {
       "type": "integer",
       "default": 20,
       "maximum": 50,
       "minimum": 1
      },
      "naics": {
       "type": "string",
       "pattern": "^\\d{2,6}$"
      },
      "since": {
       "type": "string",
       "format": "date",
       "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
       "description": "Awards starting on/after this date"
      },
      "vendor": {
       "type": "string",
       "maxLength": 120,
       "minLength": 2,
       "description": "Substring match on recipient name"
      },
      "min_value_usd": {
       "type": "number",
       "minimum": 0
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object",
     "required": [
      "data",
      "meta"
     ],
     "properties": {
      "data": {
       "type": "object",
       "required": [
        "awards"
       ],
       "properties": {
        "awards": {
         "type": "array",
         "items": {
          "type": "object",
          "required": [
           "vendor",
           "agency",
           "description",
           "value_usd",
           "award_date"
          ],
          "properties": {
           "naics": {
            "type": "string"
           },
           "agency": {
            "type": "string"
           },
           "vendor": {
            "type": "string"
           },
           "value_usd": {
            "type": "number"
           },
           "award_date": {
            "type": "string"
           },
           "sub_agency": {
            "type": "string"
           },
           "description": {
            "type": "string"
           },
           "place_of_performance": {
            "type": "string"
      
… (truncated)
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "data": {
   "awards": []
  },
  "meta": {
   "docs": "https://x402-factory.com/docs/gov.awards.dhs",
   "sources": [
    "USAspending"
   ],
   "version": "1.0.0",
   "endpoint": "/v1/contracts/awards/dhs",
   "data_mode": "live",
   "freshness": "daily",
   "request_id": "req_00000000",
   "generated_at": "2026-08-21T03:58:58.071Z"
  }
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/x402-factory-dhs-contract-awards-feed-10edc401/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from x402-factory.com](https://www.zero.xyz/host/x402-factory.com/llms.txt)