# GovDeals Live Auction Search

> GovDeals Live Auction Search is a paid API for AI agents from api.companyrecords-api.workers.dev, paid per call via x402, $0.002/call, status unknown (last checked 2026-10-24).

Searches live US government surplus auctions on GovDeals by keyword, returning asset details, current bids, reserve status, auction timing, and seller agency information.

## Facts

- Endpoint: GET https://api.companyrecords-api.workers.dev/api/gov/govdeals?utm_source=zero.xyz
- Price: $0.002/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-24
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/govdeals-live-auction-search-7ee9d93c
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_EBe01iCodH-7obqYiJvgF

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 govdeals-live-auction-search-7ee9d93c
```

Example prompt: Search GovDeals government surplus auctions for 'forklift', sort by ending soonest, and show me the first 10 results including current bids and whether the reserve has been met.

## When to prefer this

Use this endpoint when you need real-time data from US government surplus auctions specifically listed on GovDeals, including live bid prices, reserve status, and precise auction end times. Prefer this over generic web search when you need structured, machine-readable auction data with consistent fields for comparison or monitoring. Best for procurement agents, fleet managers, or bargain hunters targeting government-disposed assets.

## Known failure modes

- Missing required 'q' keyword parameter returns a validation error
- No matching auctions for the keyword returns an empty items array with total 0
- Invalid sort value may fall back to default or return an error
- Page number beyond available results returns empty items array
- GovDeals upstream unavailability may cause timeout or error response
- Limit value outside 1-100 range may return a validation error

## How this service works

Pay-per-call company registry, government, legal and B2B data tools for AI agents, from official registers and public sources. Payment: x402, USDC on Base, Solana, Arc, Polygon, Arbitrum, Monad, World Chain, Optimism, Avalanche, Celo or Stellar, or RLUSD/XRP on the XRP Ledger. No signup, no API key; a failed call is not charged.

## Output

Returns a JSON object with the search keyword, page, sort order, total matching auction count, source URL, check timestamp, and an array of auction items each containing: asset ID, title, make, model, model year, category, current bid in USD, reserve-not-met flag, auction start and end datetimes (UTC and local), time remaining, seller agency name, city, state, ZIP, country, photo URL, and asset URL on GovDeals.

## 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": [
      "q"
     ],
     "properties": {
      "q": {
       "type": "string",
       "description": "Keyword, e.g. truck, forklift, laptop (required)"
      },
      "page": {
       "type": "string",
       "description": "Page number from 1 (default 1)"
      },
      "sort": {
       "type": "string",
       "description": "relevance (default), ending, newest, price_high or price_low"
      },
      "limit": {
       "type": "string",
       "description": "Results per page, 1 to 100 (default 24)"
      }
     }
    }
   },
   "additionalProperties": false
  },
  "output": {
   "type": "object",
   "required": [
    "type"
   ],
   "properties": {
    "type": {
     "type": "string"
    },
    "example": {
     "type": "object"
    }
   }
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "q": "truck",
  "page": 1,
  "sort": "relevance",
  "count": 5,
  "items": [
   {
    "url": "https://www.govdeals.com/asset/10/29908",
    "zip": "19380",
    "city": "West Chester",
    "make": "Freightliner",
    "model": "M2 106",
    "photo": "https://webassets.lqdt1.com/assets/photos/29908/29908_10_0e79a5b1-768e-481b-bb69-5982df9e0020.jpg?cb=261015164735",
    "state": "PA",
    "title": "2004 Altec A77T On 2004 Freightliner M2 106 6x6 Bucket Truck",
    "endsAt": "2026-10-27T18:33:00Z",
    "seller": "Seller 29908 - PTKSLS",
    "assetId": 10,
    "country": "USA",
    "category": "Bucket Trucks",
    "currency": "USD",
    "startsAt": "2026-10-22T14:48:00",
    "accountId": 29908,
    "modelYear": "2004",
    "currentBid": 3000,
    "endsAtLocal": "October 27, 2026 02:33 PM EDT",
    "reserveNotMet": true,
    "timeRemaining": "4:8:55:52"
   },
   {
    "url": "https://www.govdeals.com/asset/8/29128",
    "zip": "04967",
    "city": "Pittsfield",
    "make": "Freightliner/Terex",
    "model": "M2 106",
    "photo": "https://webassets.lqdt1.com/assets/photos/29128/29128_8_46d036ff-76ad-4a7b-8fd6-895118cb5dc5.jpeg?cb=260821120645",
    "state": "ME",
    "title": "2015 Freightliner, M2 106 with Terex, HRX-55 Bucket Truck Qty 1",
    "endsAt": "2026-10-29T21:00:00Z",
    "seller": "Cianbro",
    "assetId": 8,
    "country": "USA",
    "category": "Bucket Trucks",
    "currency": "USD",
    "startsAt": "2026-10-14T11:06:00",
    "accountId": 29128,
    "modelYear": "2015",
    "currentBid": 8000,
    "endsAtLocal": "October 29, 2026 05:00 PM EDT",
    "reserveNotMet": true,
    "timeRemaining": "6:11:22:52"
   }
  ],
  "total": 7491,
  "source": "https://www.govdeals.com/en/search?kWord=truck",
  "checkedAt": "2026-10-23T09:37:07.655Z"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/govdeals-live-auction-search-7ee9d93c/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.companyrecords-api.workers.dev](https://www.zero.xyz/host/api.companyrecords-api.workers.dev/llms.txt)