Get an inventory line

​

Returns a single inventory line of yours by its id.

The response carries the line's product, finish, condition (or grading), language, quantity, publication state, and listing price when it is for sale.

Requires the inventory:read scope.

Path Parameters

  • inventoryId
    Type: string
    min length:  
    1
    required

    The inventory line's identifier. Returned by GET /v1/inventory. Path parameter.

Responses

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

{
  "id": "665f3a2b1c8d4e9f7a6b5c4d",
  "customId": "YRG|5555-5DS1-2EX-006-f-2-2008-08-01",
  "comment": "Slight edge wear on the back corner",
  "notes": "Bought at the March show",
  "location": "Shelf A",
  "tags": [
    "Trade binder",
    "Graded pile"
  ],
  "productId": 50212,
  "game": "ygo",
  "finish": "Standard",
  "condition": "NM",
  "language": "en",
  "quantity": 5,
  "graded": null,
  "forSale": true,
  "listing": {
    "price": {
      "amount": 42.5,
      "currency": "EUR"
    }
  },
  "photos": [
    {
      "url": "https://ik.imagekit.io/cardnexus/cardpicture/2026-06-01T17-40-02-3f9c1a7b2e4d-front.jpg",
      "width": 1600,
      "height": 1200
    }
  ],
  "updatedAt": "2026-06-01T17:40:02.000Z"
}

Inventory line returned.

Previous
Read the value history of your inventory
Next
Delete an inventory line