Get your listings

​

Returns the inventory lines you have published to the Marketplace, as a cursor-paginated list ordered by line id.

This is GET /v1/inventory restricted to lines that are for sale — every line in the response has forSale set to true and carries a listing price. Lines in your Collection are not included.

Filter with any combination of game, productId (repeatable), condition, language, finish, graded, customId, customIdPrefix, customIdContains, commentContains, location, and tags (repeatable — matches lines carrying any of the named tags). Filters are combined with AND.

Walk the full set by following pagination.nextCursor until it comes back null. limit defaults to 50, maximum 100.

Requires the listings:read scope.

Query Parameters
  • cursor
    Type: string
  • limit
    Type: integer
    min:  
    1
    max:  
    100

    Integer numbers.

  • game
    Type: string
    min length:  
    1

    Return only lines for this game, given as a slug, e.g. ygo.

  • productId
    Type: array …200

    Return only lines for these products. Repeat the parameter to pass several, up to 200 per call. Product ids come from GET /v1/products.

      • Type: number
  • 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 lines in this language, as a two-letter code, e.g. en.

  • finish
    Type: string enum

    Return only lines with this finish, e.g. Standard, Foil, Reverse Holo.

    values
    • Standard

      A standard, non-foil card.

    • Foil

      A foil card.

    • Rainbow
    • Gold
    • Rainbow Foil
  • graded
    Type: boolean

    true returns only graded cards; false returns only raw cards. Omit to return both.

  • customId
    Type: string
    min length:  
    1

    Return the line whose customId exactly equals this value.

  • customIdPrefix
    Type: string
    min length:  
    1

    Return lines whose customId starts with this value.

  • customIdContains
    Type: string
    min length:  
    1

    Return lines whose customId contains this value, case-insensitively.

  • commentContains
    Type: string
    min length:  
    1

    Return lines whose comment contains this value, case-insensitively.

  • location
    Type: string
    min length:  
    1
    max length:  
    100

    Return only lines stored at this location, by name. Matched case-insensitively.

  • tags
    Type: array string[] …50
    min length:  
    1
    max length:  
    100

    Return only lines carrying any of these tags, by name. Repeat the parameter to pass several, up to 50 per call. To require all tags on a line, use POST /v1/inventory/search.

Responses
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
Request Example for get/listings
curl https://public-api.cardnexus.com/v1/listings \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "data": [
    {
      "id": "665f3a2b1c8d4e9f7a6b5c4d",
      "customId": "YRG|5555-5DS1-2EX-006-f-2-2008-08-01",
      "comment": "Pack fresh, straight into a toploader",
      "productId": 50212,
      "game": "ygo",
      "finish": "Standard",
      "condition": "NM",
      "language": "en",
      "quantity": 5,
      "graded": null,
      "forSale": true,
      "listing": {
        "price": {
          "amount": 42.5,
          "currency": "EUR"
        }
      },
      "updatedAt": "2026-06-01T17:40:02.000Z"
    }
  ],
  "pagination": {
    "nextCursor": null
  }
}

Listings returned.