---
title: "One listing by id or slug"
method: GET
path: "/api/v1/listings/{id}"
---

# One listing by id or slug

`GET /api/v1/listings/{id}`

## Request

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

## Path parameters

- `id` string, required

## Response `200`

The listing

- object
  - `data` Listing
    - `id` string, uuid
    - `title` string
    - `category` string: One of: vehicles, heavy-equipment, electronics, office-furniture (displayed as Furniture), tools-industrial, medical-scientific, military-surplus, real-estate, seized-property, jewelry-coins, apparel, toys-media, appliances, sporting-outdoor, antiques-collectibles, vehicle-parts (parts and accessories; whole vehicles stay in vehicles), other
    - `source` string: Source key, e.g. govdeals
    - `source_name` string
    - `state` string, nullable: 2-letter US state code
    - `city` string, nullable
    - `zip` string, nullable
    - `current_bid_cents` integer, nullable
    - `buy_now_cents` integer, nullable
    - `starting_bid_cents` integer, nullable
    - `num_bids` integer
    - `flip_score` integer, nullable: BidProwl deal score
    - `condition_grade` string, nullable
    - `vin` string, nullable: 17-character vehicle identification number when the source publishes one (validated: no I, O or Q), else null
    - `quantity` integer, nullable: Units in the lot, from the source's own field or the count its title or description states ("Lot of (5) ..."). Null when not stated, which is most lots: null does not mean 1
    - `quantity_approx` boolean, nullable: True when the stated count is approximate ("approx 50", "40+"); null when quantity is null
    - `quantity_unit` 'item' | 'container' | 'null', nullable: item, or container when the count is of pallets, boxes or cases; null when quantity is null
    - `bid_is_per_unit` boolean: True when the source takes bids per unit (HiBid lots shown as "x 20"). current_bid_cents is then the lot total, unit bid times quantity
    - `unit_bid_cents` integer, nullable: current_bid_cents divided by quantity when quantity > 1, the count is exact and there is a bid; the source's per-unit bid when bid_is_per_unit
    - `image_url` string, nullable
    - `start_date` string, date-time, nullable
    - `end_date` string, date-time, nullable
    - `status` string
    - `bidprowl_url` string
    - `source_url` string: Official auction page where bidding happens

## Other responses

- `401`: Missing, invalid or revoked API key.
- `404`: No such listing.
- `429`: Per-minute burst limit or monthly quota exhausted. Read Retry-After, and RateLimit-* to self-throttle before you get here.

---

[API](https://skmtc.dev/bidprowl/apis/bidprowl-api.md) · [All operations](https://skmtc.dev/bidprowl/apis/bidprowl-api/llms.txt) · [OpenAPI document](https://skmtc.dev/bidprowl/apis/bidprowl-api/revisions/5cf442eea08b?raw)