---
title: "Get one Alt listing's full public detail"
method: GET
path: "/alt/listing"
tags: ["Alt"]
---

# Get one Alt listing's full public detail

`GET /alt/listing`

## Request

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

One listing's full public detail -- title, description, price/bid state, grading info, and images -- across Alt's own native listings and its aggregated external listings. id and listing_type come from a prior alt-search/alt-auctions result, or from an alt-sold-listings result's listing_id and listing_type for a completed sale on Alt itself. Not every response field applies to every listing_type -- see the field-level notes in this endpoint's markdown doc.

## Query parameters

- `id` string, required
- `listing_type` 'AUCTION' | 'FIXED_PRICE' | 'EXTERNAL_AUCTION' | 'EXTERNAL_FIXED_PRICE', required

## Headers

- `x-api-key` string, required

## Response `200`

OK

- AltListingResponseDoc
  - `code` integer
  - `data` AltListingResult
    - `alt_value` number: AltValue is Alt's own estimated market value, only present for native listings.
    - `auction_ends_at` string
    - `auction_house` string
    - `autograph` string
    - `badges` string[]
    - `bid_count` integer
    - `brand` string
    - `card_number` string
    - `category` string
    - `cert_number` string
    - `created_at` string
    - `current_bid` number: CurrentBid and BidCount are only present for external auction listings -- Alt's own native auctions do not expose live bid state through this endpoint.
    - `description` string
    - `expires_at` string: ExpiresAt is only present for native listings; AuctionEndsAt is only present for external auction listings.
    - `external_url` string: ExternalURL is the click-through link back to the original listing on its source site -- only present for external listings.
    - `grade` string
    - `grading_company` string
    - `id` string
    - `images` AltImage[]
      - `position` string
      - `url` string
    - `list_price` number: ListPrice is Alt's own asking/list price (native) or the source site's Buy It Now price (external, when the listing has one).
    - `listing_type` string
    - `name` string
    - `print_run` integer
    - `qualifier` string
    - `serial` integer
    - `state` string: State is only present for Alt's own native listings (e.g. ACTIVE).
    - `subject` string
    - `variety` string
    - `year` integer
  - `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/afac9b012a27?raw)