# BidHatch Government Contract Bids API

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

Search and filter open U.S. federal government contract opportunities from SAM.gov, filtered for small trade businesses like box truckers, janitorial, landscaping, and HVAC operators.

## Facts

- Endpoint: GET https://bidhatch.pages.dev/api/v1/bids?utm_source=zero.xyz
- Price: $0.02/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-contract-bids-api-96b08230
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_xKdVificKiaL5OpFdICft

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-contract-bids-api-96b08230
```

Example prompt: Can you find open federal government contracts for janitorial services in Texas that are set aside for small businesses and due in the next 30 days?

## When to prefer this

Use BidHatch when you specifically need federal government contract opportunities filtered for small trade businesses such as freight haulers, janitorial, HVAC, landscaping, pest control, courier, or moving companies. Prefer this over raw SAM.gov API access when you want pre-categorized trade tags and a simpler query interface. This is ideal for owner-operators and small business agents monitoring bids daily without needing to parse all of SAM.gov directly.

## Known failure modes

- No results returned if filters are too narrow or no matching bids exist for given date range or trade
- Invalid query parameter values (e.g. malformed NAICS code or state abbreviation) may return empty results or errors
- Stale data if SAM.gov has not synced yet for that day (data updated daily, not real-time)
- Exceeding limit parameter range (must be 1-100) may cause invalid request
- Too many NAICS codes in comma-separated list (max 10) may cause rejection

## 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 paginated JSON list of open federal contract opportunities including title, agency, NAICS/PSC codes, solicitation type, set-aside classification, place of performance city and state, posting date, deadline, SAM.gov link, and BidHatch trade tags. Includes a count of results and total matching records.

## 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": "keywords in title/description"
      },
      "psc": {
       "type": "string",
       "description": "PSC code or prefix"
      },
      "sort": {
       "type": "string",
       "description": "deadline|posted"
      },
      "type": {
       "type": "string",
       "description": "solicitation|combined|presolicitation|sources-sought|special-notice"
      },
      "limit": {
       "type": "string",
       "description": "1-100, default 50"
      },
      "naics": {
       "type": "string",
       "description": "NAICS code or prefix, comma-separated (max 10)"
      },
      "state": {
       "type": "string",
       "description": "2-letter place-of-performance state(s), comma-separated"
      },
      "trade": {
       "type": "string",
       "description": "BidHatch trade tag: janitorial, landscaping-snow, pest-control, hvac, plumbing, electrical, freight-hauling, courier, moving, facility-maintenance"
      },
      "agency": {
       "type": "string"
      },
      "offset": {
       "type": "string"
      },
      "setaside": {
       "type": "string",
       "description": "Set-aside code prefix: SBA, 8A, SDVOSBC, WOSB, EDWOSB, HZC, VSA, ANY, NONE"
      },
      "due_after": {
       "type": "string",
       "description": "YYYY-MM-DD"
      },
      "due_before": {
       "type": "string",
       "description": "YYYY-MM-DD"
      },
      "posted_since": {
       "type": "string",
       "description": "YYYY-MM-DD"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "count": 1,
  "total": 41,
  "results": [
   {
    "id": "abc123",
    "psc": "S201",
    "link": "https://sam.gov/opp/abc123/view",
    "type": "Combined Synopsis/Solicitation",
    "naics": "561720",
    "title": "Janitorial Services - Federal Building",
    "agency": "PUBLIC BUILDINGS SERVICE",
    "posted": "2026-10-15",
    "trades": [
     "janitorial"
    ],
    "deadline": "2026-11-03T21:00:00Z",
    "pop_city": "Austin",
    "setaside": "Total Small Business Set-Aside (FAR 19.5)",
    "pop_state": "TX",
    "setaside_code": "SBA"
   }
  ]
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/bidhatch-government-contract-bids-api-96b08230/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)