Get your inventory lines

​

Returns your inventory lines, newest writes included, as a cursor-paginated list ordered by line id.

Each line carries its product, finish, condition (or grading), language, quantity, and — when it is for sale — its listing price. forSale is true for lines published to the Marketplace and false for lines kept in your Collection.

Filter with any combination of game, productId (repeatable), forSale, 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: pass it back as cursor until it comes back null. The id order is stable, so a sweep stays consistent while you write to your inventory. limit defaults to 50, maximum 100.

This endpoint is for reading and syncing your inventory: it always reflects your latest changes and walks every line to the end. To find lines instead — free-text product-name search, all-of tag matching, relevance ranking — use POST /v1/inventory/search; both return the same line shape.

Requires the inventory: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.

  • condition
    Type: 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: stringenum

    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
    • Cold Foil
    • Gold Foil
    • Etched

      A card with an etched-foil finish.

  • 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 of 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.

  • forSale
    Type: boolean

    true returns only lines published to the Marketplace; false returns only lines in your Collection. Omit to return both.

Responses

  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
Request Example for get/inventory
curl 'https://public-api.cardnexus.com/v1/inventory?limit=50&finish=Standard' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN'

{
  "data": [
    {
      "id": "665f3a2b1c8d4e9f7a6b5c4d",
      "customId": "YRG|5555-5DS1-2EX-006-f-2-2008-08-01",
      "comment": "From a sealed box, sleeved straight away",
      "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"
    },
    {
      "id": "665f3a2b1c8d4e9f7a6b5c50",
      "customId": null,
      "comment": null,
      "productId": 50213,
      "game": "mtg",
      "finish": "Foil",
      "condition": "LP",
      "language": "en",
      "quantity": 2,
      "graded": null,
      "forSale": false,
      "listing": null,
      "updatedAt": "2026-05-22T08:11:47.000Z"
    }
  ],
  "pagination": {
    "nextCursor": "NjY1ZjNhMmIxYzhkNGU5ZjdhNmI1YzUw"
  }
}

Inventory lines returned.

Previous
Lines
Next
Add inventory lines