Get a product's listings

Returns the Marketplace listings for a catalogue product — every listing's price, quantity for sale, the card's condition and language, and the seller behind it.

Listings are sorted by price, cheapest first; when sellers list in different currencies, prices are compared in a common currency for the sort. Each listing's price stays in the currency the seller lists in.

Filter with any combination of condition, language, finish, and region. Pass deliveryCountry to keep only listings from sellers who ship to you — each listing then carries the seller's shipping charge under seller.shipping.

Results are paginated: follow pagination.nextCursor by passing it back as cursor until it comes back null. limit defaults to 50, maximum 100.

To buy from a listing, pass its listingId to POST /v1/cart/items.

Requests count against the product-listings rate limit: 120 requests per hour. If your integration needs more, contact support with your username and what you're building — limits can be raised per account.

Authentication is required (any valid API key); no scope.

Path Parameters

productId
required

The catalogue product. Product ids come from GET /v1/products. Path parameter.
Type: number

The catalogue product. Product ids come from GET /v1/products. Path parameter.

Query Parameters

cursor
Type: string
limit
Type: integer
min:
1
max:
100

Integer numbers.
condition
Type: string · enum

Card condition: NM (Near Mint), LP (Lightly Played), MP (Moderately Played), HP (Heavily Played), DMG (Damaged).
values
- NM
  
  Near Mint.
- LP
  
  Lightly Played.
- MP
  
  Moderately Played.
- HP
  
  Heavily Played.
- DMG
  
  Damaged.
language
Type: string
min length:
1

Return only listings in this language, as a two-letter code, e.g. en.
finish
Type: string enum

Return only listings with this finish, e.g. Standard, Foil, Reverse Holo.
values
- Standard
  
  A standard, non-foil card.
- Foil
  
  A foil card.
- Rainbow
- Gold
- Rainbow Foil
region
Type: string enum

Return only listings from sellers in this region: eu or na.
values
- eu
  
  Europe.
- na
  
  North America — the United States and Canada.
deliveryCountry
Type: string
min length:
2
max length:
2

Your delivery country as a two-letter ISO 3166-1 alpha-2 code, e.g. FR. When set, only listings from sellers who ship there are returned, and each listing carries the seller's shipping charge.

Responses

application/json
application/json
application/json
application/json
application/json
application/json
application/json
application/json

get/products/{productId}/listings

curl https://public-api.cardnexus.com/v1/products/50212/listings \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

Show Schema

{
  "data": [
    {
      "listingId": "665f3a2b1c8d4e9f7a6b5c52",
      "price": {
        "amount": 4.5,
        "currency": "EUR"
      },
      "quantity": 3,
      "condition": "NM",
      "language": "en",
      "finish": "Standard",
      "graded": null,
      "comment": "Pack fresh, straight into a toploader",
      "seller": {
        "id": "665f3a2b1c8d4e9f7a6b5c4d",
        "username": "north_arena_tcg",
        "country": "DE",
        "type": "pro",
        "rating": {
          "average": 4.9,
          "count": 214
        },
        "shipping": {
          "amount": 3.5,
          "currency": "EUR"
        }
      }
    },
    {
      "listingId": "665f3a2b1c8d4e9f7a6b5c61",
      "price": {
        "amount": 5.25,
        "currency": "EUR"
      },
      "quantity": 1,
      "condition": "LP",
      "language": "en",
      "finish": "Standard",
      "graded": null,
      "comment": null,
      "seller": {
        "id": "665f3a2b1c8d4e9f7a6b5c77",
        "username": "alphabay_cards",
        "country": "FR",
        "type": "individual",
        "rating": {
          "average": 4.7,
          "count": 51
        },
        "shipping": {
          "amount": 2.9,
          "currency": "EUR"
        }
      }
    }
  ],
  "pagination": {
    "nextCursor": null
  }
}

Listings returned.