---
title: "Get one Goldin lot's full public detail"
method: GET
path: "/goldin/listing"
tags: ["Goldin"]
---

# Get one Goldin lot's full public detail

`GET /goldin/listing`

## Request

- Base URL: `https://api.crawlora.net/api/v1`
- URL: `https://api.crawlora.net/api/v1/goldin/listing`
- Auth: API key in header `x-api-key`

One lot's full public detail: title, description, current bid/starting price, auction window and status, grading info, images, and prev/next lot pointers within the same auction. slug is the meta_slug from a goldin-search result (or the trailing path segment of the lot's own goldin.co/item/{slug} page URL).

## Query parameters

- `slug` string, required

## Headers

- `x-api-key` string, required

## Response `200`

OK

- GoldinListingResponseDoc
  - `code` integer
  - `data` GoldinListingResult
    - `allow_offers` boolean: AllowOffers, SoldAt, and FinalPrice are only present for AuctionType "Fixed_Price" lots (Goldin's Buy Now marketplace).
    - `auction_id` string
    - `auction_name` string
    - `auction_type` string
    - `buyer_premium` number
    - `category` string
    - `current_price` integer
    - `description` string
    - `end_time` string
    - `final_price` integer
    - `grading_company` string: GradingCompany is the third-party grader, e.g. "PSA" -- present only for graded items. Not the same enum as Search's certification filter, which also includes "Ungraded".
    - `images` string[]
    - `item_type` string
    - `lot_id` string
    - `lot_number` integer
    - `min_bid_price` integer
    - `next_lot` GoldinListingLotRef
      - `lot_number` integer
      - `slug` string
    - `number_of_bids` integer
    - `number_of_views` integer
    - `previous_lot` GoldinListingLotRef
      - `lot_number` integer
      - `slug` string
    - `reserve_amount` number
    - `serial_number` string
    - `slug` string
    - `sold_at` string
    - `source_url` string
    - `start_time` string
    - `status` string
    - `sub_category` string
    - `title` string
  - `msg` string

## Other responses

- `400`: Bad Request
- `404`: Not Found
- `500`: Internal Server Error
- `503`: Service Unavailable

---

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