Listing

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/bidprowl-com/json-schema/bidprowl-com-listing-schema.json",
  "title": "Listing",
  "x-generated": "2026-11-02",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/bidprowl-com-openapi.json#/components/schemas/Listing",
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "format": "uuid"
    },
    "title": {
      "type": "string"
    },
    "category": {
      "type": "string",
      "description": "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": {
      "type": "string",
      "description": "Source key, e.g. govdeals"
    },
    "source_name": {
      "type": "string"
    },
    "state": {
      "type": [
        "string",
        "null"
      ],
      "description": "2-letter US state code"
    },
    "city": {
      "type": [
        "string",
        "null"
      ]
    },
    "zip": {
      "type": [
        "string",
        "null"
      ]
    },
    "current_bid_cents": {
      "type": [
        "integer",
        "null"
      ]
    },
    "buy_now_cents": {
      "type": [
        "integer",
        "null"
      ]
    },
    "starting_bid_cents": {
      "type": [
        "integer",
        "null"
      ]
    },
    "num_bids": {
      "type": "integer"
    },
    "flip_score": {
      "type": [
        "integer",
        "null"
      ],
      "description": "BidProwl deal score"
    },
    "condition_grade": {
      "type": [
        "string",
        "null"
      ]
    },
    "vin": {
      "type": [
        "string",
        "null"
      ],
      "description": "17-character vehicle identification number when the source publishes one (validated: no I, O or Q), else null"
    },
    "quantity": {
      "type": [
        "integer",
        "null"
      ],
      "description": "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": {
      "type": [
        "boolean",
        "null"
      ],
      "description": "True when the stated count is approximate (\"approx 50\", \"40+\"); null when quantity is null"
    },
    "quantity_unit": {
      "type": [
        "string",
        "null"
      ],
      "enum": [
        "item",
        "container",
        null
      ],
      "description": "item, or container when the count is of pallets, boxes or cases; null when quantity is null"
    },
    "bid_is_per_unit": {
      "type": "boolean",
      "description": "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": {
      "type": [
        "integer",
        "null"
      ],
      "description": "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": {
      "type": [
        "string",
        "null"
      ]
    },
    "start_date": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time"
    },
    "end_date": {
      "type": [
        "string",
        "null"
      ],
      "format": "date-time"
    },
    "status": {
      "type": "string"
    },
    "bidprowl_url": {
      "type": "string"
    },
    "source_url": {
      "type": "string",
      "description": "Official auction page where bidding happens"
    }
  }
}