Gov Auctions

Gov Auctions API

Gov Auctions API as documented publicly: 18 operations. Contract generated from the documentation by API Evangelist (2026-11-10); not the provider's own document.

GitHub OpenAPI

Operations 18

GET /api/v1/comps GET /api/v1/comps #
POST /api/v1/comps/batch POST /api/v1/comps/batch #
GET /api/v1/flip-score GET /api/v1/flip-score #
GET /api/v1/listings Live GSA lots — filter by state, category, price, keyword or ZIP radius #
POST /api/v1/listings POST /api/v1/listings #
POST /api/v1/webhooks Manage push subscriptions for new lots #
GET /comps Sold-price range (p25 / median / p75); add include=comps for the underlying sales #
POST /comps/batch Up to 100 items valued in one request #
GET /comps/trend Month-by-month medians, plus the first-to-last change #
GET /coverage Sales held per category, and what we can never price #
GET /export Bulk CSV (pay as you go and above); comps exports charge one valuation call per priced query #
GET /flip-score Resale signal for a live lot: estimated value, effective bid, discount #
GET /listings Live GSA lots — filter by state, category, price, keyword or ZIP radius #
GET /listings/{id} One live lot by id #
GET /sold The individual archived sales behind an item: price, month, state #
GET /sources Listing sources and comp markets we cover, with counts #
GET /usage Both budgets and the reset date for your key #
POST /webhooks Manage push subscriptions for new lots #

Specifications

⚙
OpenAPI
https://artifacts.apis.io/govauctions-app/openapi/_ae-authored/govauctions-app-openapi-generated.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/govauctions-app/json-schema/govauctions-app-post-api-v1-webhooks-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/govauctions-app/json-schema/govauctions-app-post-webhooks-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/govauctions-app/json-schema/govauctions-app-post-api-v1-webhooks-response-schema.json
📊
JSONSchema
https://artifacts.apis.io/govauctions-app/json-schema/govauctions-app-post-comps-batch-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/govauctions-app/json-schema/govauctions-app-get-api-v1-listings-response-schema.json
📊
JSONSchema
https://artifacts.apis.io/govauctions-app/json-schema/govauctions-app-post-api-v1-comps-batch-request-schema.json

Other Resources

🔗
APIsJSON
https://artifacts.apis.io/govauctions-app/apis.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/govauctions-app:govauctions-app-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

govauctions-app-openapi-generated.yml Raw ↑ 
openapi: 3.1.0
info:
  title: Gov Auctions API
  version: '2026-11-10'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-11-10: 18 operation(s) read from 1 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; Gov Auctions has published no machine-readable contract that
    the pipeline could find. Engine: local.'
  x-evidence-tiers:
    code-example: 4
    documentation: 14
    pages-with-code: 1
    pages-read: 1
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-11-10'
  x-generator: generate-contract-from-docs.py
  x-engine: local
  x-sources:
  - https://govauctions.app/developers
paths:
  /api/v1/comps:
    get:
      operationId: get_api_v1_comps
      tags:
      - Api
      summary: GET /api/v1/comps
      x-source: https://govauctions.app/developers
      parameters:
      - name: include
        in: query
        required: false
        schema:
          type: string
      - name: q
        in: query
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl "https://govauctions.app/api/v1/comps?q=2015+Ford+F-150&include=comps"  -H "Authorization: Bearer YOUR_API_KEY"'
  /api/v1/comps/batch:
    post:
      operationId: post_api_v1_comps_batch
      tags:
      - Api
      summary: POST /api/v1/comps/batch
      x-source: https://govauctions.app/developers
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiV1CompsBatchRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl -X POST https://govauctions.app/api/v1/comps/batch  -H "Authorization: Bearer YOUR_API_KEY"  -H "Content-Type: application/json"  -d
          ''{"queries":["2015 Ford F-150","forklift","Dell Latitude"]}'' Webhooks Register an https endpoint with a filter and we POST matching
          new lots as they enter the feed, with new listings every 30 minutes. Every delivery is signed with HMAC-SHA256 in the X-GovAuction'
  /api/v1/flip-score:
    get:
      operationId: get_api_v1_flip_score
      tags:
      - Api
      summary: GET /api/v1/flip-score
      x-source: https://govauctions.app/developers
      parameters:
      - name: id
        in: query
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl "https://govauctions.app/api/v1/flip-score?id=LOT_ID_FROM_ABOVE"  -H "Authorization: Bearer YOUR_API_KEY" Listings are
          free and don''t use valuation calls. flip-score returns the estimated value, the effective bid including buyer''s premium, and the discount
          between them. With credits, you can stop polling: register the same filter as a webhook below. Ask Claude No code at all: add the MCP
          serv'
  /api/v1/listings:
    get:
      operationId: get_api_v1_listings
      tags:
      - Api
      summary: Live GSA lots — filter by state, category, price, keyword or ZIP radius
      x-source: https://govauctions.app/developers
      parameters:
      - name: country
        in: query
        required: false
        schema:
          type: string
        description: Country code (e.g., US)
      - name: state
        in: query
        required: false
        schema:
          type: string
        description: State filter
      - name: category
        in: query
        required: false
        schema:
          type: string
        description: Category filter
      - name: price
        in: query
        required: false
        schema:
          type: string
        description: Price filter
      - name: q
        in: query
        required: false
        schema:
          type: string
        description: Keyword search
      - name: zip
        in: query
        required: false
        schema:
          type: string
        description: ZIP code for radius search
      - name: radiusMiles
        in: query
        required: false
        schema:
          type: integer
        description: Radius in miles around ZIP
      - name: limit
        in: query
        required: false
        schema:
          type: integer
        description: Maximum number of results
      - name: sort
        in: query
        required: false
        schema:
          type: string
        description: Sorting order (e.g., newest)
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiV1ListingsResponse'
      x-evidence:
        kind: documentation
    post:
      operationId: post_api_v1_listings
      tags:
      - Api
      summary: POST /api/v1/listings
      x-source: https://govauctions.app/developers
      parameters:
      - name: category
        in: query
        required: false
        schema:
          type: string
      - name: country
        in: query
        required: false
        schema:
          type: string
      - name: limit
        in: query
        required: false
        schema:
          type: string
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl https://govauctions.app/api/v1/listings?country=US&category=vehicles&limit=5  -H "Authorization: Bearer YOUR_API_KEY" Using
          AI tools? Point ChatGPT Actions or a codegen client at the OpenAPI spec , or add our hosted MCP server below. Recipes The jobs people
          actually use the API for. Each one runs as written once you swap in your key. Check a lot before you bid What did the same item sell
          for '
  /api/v1/webhooks:
    post:
      operationId: post_api_v1_webhooks
      tags:
      - Api
      summary: Manage push subscriptions for new lots
      x-source: https://govauctions.app/developers
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostApiV1WebhooksRequest'
      responses:
        '201':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/PostApiV1WebhooksResponse'
      x-evidence:
        kind: documentation
  /comps:
    get:
      operationId: get_comps
      tags:
      - Comps
      summary: Sold-price range (p25 / median / p75); add include=comps for the underlying sales
      x-source: https://govauctions.app/developers
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /comps/batch:
    post:
      operationId: post_comps_batch
      tags:
      - Comps
      summary: Up to 100 items valued in one request
      x-source: https://govauctions.app/developers
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostCompsBatchRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /comps/trend:
    get:
      operationId: get_comps_trend
      tags:
      - Comps
      summary: Month-by-month medians, plus the first-to-last change
      x-source: https://govauctions.app/developers
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /coverage:
    get:
      operationId: get_coverage
      tags:
      - Coverage
      summary: Sales held per category, and what we can never price
      x-source: https://govauctions.app/developers
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /export:
    get:
      operationId: get_export
      tags:
      - Export
      summary: Bulk CSV (pay as you go and above); comps exports charge one valuation call per priced query
      x-source: https://govauctions.app/developers
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /flip-score:
    get:
      operationId: get_flip_score
      tags:
      - Flip Score
      summary: 'Resale signal for a live lot: estimated value, effective bid, discount'
      x-source: https://govauctions.app/developers
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /listings:
    get:
      operationId: get_listings
      tags:
      - Listings
      summary: Live GSA lots — filter by state, category, price, keyword or ZIP radius
      x-source: https://govauctions.app/developers
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /listings/{id}:
    get:
      operationId: get_listings_id
      tags:
      - Listings
      summary: One live lot by id
      x-source: https://govauctions.app/developers
      parameters:
      - name: id
        in: path
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /sold:
    get:
      operationId: get_sold
      tags:
      - Sold
      summary: 'The individual archived sales behind an item: price, month, state'
      x-source: https://govauctions.app/developers
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /sources:
    get:
      operationId: get_sources
      tags:
      - Sources
      summary: Listing sources and comp markets we cover, with counts
      x-source: https://govauctions.app/developers
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /usage:
    get:
      operationId: get_usage
      tags:
      - Usage
      summary: Both budgets and the reset date for your key
      x-source: https://govauctions.app/developers
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
  /webhooks:
    post:
      operationId: post_webhooks
      tags:
      - Webhooks
      summary: Manage push subscriptions for new lots
      x-source: https://govauctions.app/developers
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/PostWebhooksRequest'
      responses:
        '201':
          description: Success (status as documented)
      x-evidence:
        kind: documentation
components:
  schemas:
    PostApiV1CompsBatchRequest:
      type: object
      properties:
        queries:
          type: array
          items:
            type: string
    GetApiV1ListingsResponse:
      type: object
      properties:
        listings:
          type: array
          description: Array of live lot objects
    PostApiV1WebhooksRequest:
      type: object
      properties:
        url:
          type: string
          description: Endpoint to receive webhook POSTs
        filters:
          type: object
          description: Filter criteria such as category, state, minFlipScore
      required:
      - url
      - filters
    PostApiV1WebhooksResponse:
      type: object
      properties:
        id:
          type: string
          description: Identifier of the created webhook
        secret:
          type: string
          description: Signing secret returned once at creation
    PostCompsBatchRequest:
      type: object
      properties:
        queries:
          type: array
          description: List of item queries
      required:
      - queries
    PostWebhooksRequest:
      type: object
      properties:
        url:
          type: string
          description: Endpoint to receive webhook POSTs
        filters:
          type: object
          description: Filter criteria for lot notifications
      required:
      - url
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
security:
- bearer: []
tags:
- name: Api
- name: Comps
- name: Coverage
- name: Export
- name: Flip Score
- name: Listings
- name: Sold
- name: Sources
- name: Usage
- name: Webhooks