---
title: "Get one live listing by id"
method: GET
path: "/listings/{id}"
---

# Get one live listing by id

`GET /listings/{id}`

## Request

- Base URL: `https://govauctions.app/api/v1`
- URL: `https://govauctions.app/api/v1/listings/{id}`
- Auth: HTTP bearer

## Path parameters

- `id` string, required

## Response `200`

Listing. Live lots only — this does not fall back to the sold archive.

- object
  - `data` Listing: A live lot. Price fields describe BID state, which is not the same as the figure a source's own web page shows: GSA renders a lot's opening/minimum amount in a box labelled "Current Bid" even when nobody has bid, so treat currentBid, not the source page, as the answer to "has anyone bid".
    - `id` string
    - `source` 'gsa'
    - `sourceUrl` string, uri
    - `currency` string
    - `title` string
    - `category` string
    - `condition` string
    - `sellerName` string
    - `sellerType` string
    - `currentBid` number, nullable: Highest bid actually submitted, or null when no bid has been placed. Null is a fact, not a gap: it means nobody has bid.
    - `startingBid` number, nullable: Opening/minimum amount. ALWAYS null for gsa lots: the GSA Auctions v2 feed we ingest publishes no opening-bid field (its only price-related fields are highBidAmount, biddersCount, aucIncrement and reserve), so the opening figure shown on gsaauctions.gov is not available to us. Do not read null here as "no opening price".
    - `buyerPremiumPct` number
    - `bidCount` integer: Bidders/bids reported by the source. Read together with bidStateUnknown: a 0 with bidStateUnknown absent means no bids, a 0 with bidStateUnknown true means the source did not report.
    - `bidStateUnknown` boolean: Present and true only when the source publishes no bid state, making bidCount: 0 meaningless. Absent on gsa lots, which do publish bid state.
    - `location` object
      - `city` string
      - `state` string
      - `zip` string
      - `latitude` number, nullable
      - `longitude` number, nullable
    - `startsAt` string, date-time
    - `endsAt` string, date-time
    - `active` boolean
    - `updatedAt` string, date-time, nullable
    - `distanceMiles` number: Only when zip was supplied.
    - `facts` object: Parsed attributes (year, make, model, ...) when derivable from the listing text.

## Other responses

- `404`: Not found

---

[API](https://skmtc.dev/govauctions/apis/govauctions-data-api.md) · [All operations](https://skmtc.dev/govauctions/apis/govauctions-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/govauctions/apis/govauctions-data-api/revisions/7e81b5468d24?raw)