# BidHatch Government Contracts Awards API

> BidHatch Government Contracts Awards API is a paid API for AI agents from bidhatch.pages.dev, paid per call via x402, $0.03/call, status unknown (last checked 2026-11-03).

Search and retrieve open federal government contract award records filtered by trade, industry, state, agency, and other criteria, updated daily from SAM.gov

## Facts

- Endpoint: GET https://bidhatch.pages.dev/api/v1/awards?utm_source=zero.xyz
- Price: $0.03/call
- Payment: x402
- Status: unknown
- Last checked: 2026-11-03
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/bidhatch-government-contracts-awards-api-3b165536
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_v085ob9YK1cJtTJ6wigt7

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 bidhatch-government-contracts-awards-api-3b165536
```

Example prompt: Find me open federal government contracts for janitorial or custodial services in Texas — sort by largest amount first and show me the top 10 results.

## When to prefer this

Choose this endpoint when you need to search federal government contract awards specifically targeted at owner-operators and small businesses in trade industries like trucking, janitorial, landscaping, pest control, moving, HVAC, and courier services. It is preferable over raw SAM.gov queries because it is pre-filtered for these specific NAICS codes, updated daily, and returns clean structured JSON with direct USASpending links. Use it when you need to filter by state, agency, date range, or minimum dollar amount for small business procurement discovery.

## Known failure modes

- Invalid NAICS or PSC code returns empty results rather than an error
- Date format not matching YYYY-MM-DD may return unexpected results or errors
- State codes not matching 2-letter abbreviation format may fail filtering
- Limit values outside 1-100 range may be rejected or clamped
- No results matching filters returns count:0 and empty results array
- Payment failure (402) if USDC payment not provided or insufficient

## How this service works

Open federal government contracts for box truck owners, couriers, janitorial, landscaping, pest control, moving and HVAC small businesses. Updated daily from SAM.gov.

## Output

Returns a JSON object with a count of matching records, a has_next pagination flag, and a results array. Each result includes the award ID, recipient name and UEI, award amount in dollars, description, NAICS and PSC codes, awarding agency and sub-agency, place-of-performance state, contract start and end dates, and a direct link to the USASpending.gov award page.

## 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"
     ],
     "type": "string"
    },
    "headers": {
     "type": "object",
     "additionalProperties": {
      "type": "string"
     }
    },
    "queryParams": {
     "type": "object",
     "properties": {
      "q": {
       "type": "string",
       "description": "Keyword in award description"
      },
      "psc": {
       "type": "string",
       "description": "PSC code(s)"
      },
      "sort": {
       "type": "string",
       "description": "amount (largest first) or date (most recently modified first)"
      },
      "limit": {
       "type": "string",
       "description": "1-100, default 25"
      },
      "naics": {
       "type": "string",
       "description": "NAICS code(s) or prefix, comma-separated. Covered: trade codes 4841xx-4842xx, 488510, 4921xx-4922xx, 5617xx, 238210, 238220, 238990, 811310"
      },
      "since": {
       "type": "string",
       "description": "Award start date on/after YYYY-MM-DD"
      },
      "state": {
       "type": "string",
       "description": "Place-of-performance state(s), 2-letter"
      },
      "until": {
       "type": "string",
       "description": "Award start date on/before YYYY-MM-DD"
      },
      "agency": {
       "type": "string",
       "description": "Awarding top-tier agency name, e.g. Department of Veterans Affairs"
      },
      "offset": {
       "type": "string"
      },
      "recipient": {
       "type": "string",
       "description": "Recipient (contractor) name or UEI text"
      },
      "min_amount": {
       "type": "string",
       "description": "Minimum award amount in dollars"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "results": [
   {
    "end": "2026-08-31",
    "psc": "S201",
    "naics": "561720",
    "start": "2021-02-10",
    "agency": "Department of Defense",
    "amount": 3762690.13,
    "award_id": "W9115121C0003",
    "pop_state": "TX",
    "recipient": "EXAMPLE FACILITY SERVICES LLC",
    "sub_agency": "Department of the Army",
    "description": "INSTALLATION CUSTODIAL SERVICE",
    "recipient_uei": "ABCDEFGH1234",
    "usaspending_url": "https://www.usaspending.gov/award/CONT_AWD_..."
   }
  ],
  "has_next": true
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/bidhatch-government-contracts-awards-api-3b165536/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from bidhatch.pages.dev](https://www.zero.xyz/host/bidhatch.pages.dev/llms.txt)