Search live listings (facts only, GSA Auctions)

get/listings

Request

  • Base URL: https://govauctions.app/api/v1
  • URL: https://govauctions.app/api/v1/listings
  • Auth: HTTP bearer

Query parameters

country'US'
statestring

2-letter state/region code

categorystring
source'gsa'

Source platform (sanctioned sources only; currently gsa)

qstring

Title keyword

priceMinnumber
priceMaxnumber
activeboolean
zipstring

US 5-digit ZIP to search around. Limits results to lots within radiusMiles, orders them nearest-first, and adds distanceMiles to each item plus an origin block to the response.

radiusMilesnumber

Radius from zip, in miles. Requires zip.

sort'ending-soonest' | 'newest'

Result order. Default is soonest-ending, or nearest-first when zip is given. newest orders by the lot's own listing date (auction start), newest first, with a deterministic id tie-break - use it for recurring "what's new" polling, where the default order can leave a brand-new lot off page one. Lots that have not opened yet sort to the top.

limitinteger
offsetinteger

Response

A page of listings. A zero-result page also carries a scope block naming the sources and market actually searched, so an empty data is distinguishable from "no such lots exist": raw listings are served for sanctioned public-domain sources only (gsa) in the US, while sold-price comps span the full market and all four comp markets (US, UK, Canada, Australia; the DE and FR markets carry live listings only and have no sold-price history).

Changes

No recorded changes to this operation across all 1 revision of this API.