List an inventory line for sale

​

Publishes an inventory line to the Marketplace at the given per-card price. The price currency must match your seller currency, and your seller account must be active.

By default the whole line is listed. Pass quantity to list only part of it: the listed cards move to their own line (returned as line), the rest stays in your Collection on the original line (returned as remainder). The split-off listed line inherits the original's comment but never its customId.

If listing the whole line makes it identical to one of your existing listed lines (same product, finish, condition, language, grading, and price, neither line carrying a customId), the two merge; line is the surviving line.

Send an Idempotency-Key header to make retries safe: the same key returns the same response for 24 hours.

Requires the listings:write scope.

Path Parameters
  • inventoryId
    Type: string
    min length:  
    1
    required

    The inventory line to list. Returned by GET /v1/inventory. Path parameter.

Body
required
application/json
  • price
    Type: object
    required

    The per-card price. The currency must match your seller currency.

  • quantity
    Type: integer
    min:  
    1
    max:  
    9007199254740991

    How many cards to list. Defaults to the line's full quantity. Listing fewer splits the line: the listed cards move to their own line.

Responses
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
  • application/json
Request Example for post/inventory/{inventoryId}/listing
curl 'https://public-api.cardnexus.com/v1/inventory/{inventoryId}/listing' \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{
  "price": {
    "amount": 14.99,
    "currency": "USD"
  },
  "quantity": 1
}'

{
  "line": {
    "id": "665f3a2b1c8d4e9f7a6b5c52",
    "customId": null,
    "comment": "Pack fresh, straight into a toploader",
    "productId": 50212,
    "game": "ygo",
    "finish": "Standard",
    "condition": "NM",
    "language": "en",
    "quantity": 3,
    "graded": null,
    "forSale": true,
    "listing": {
      "price": {
        "amount": 42.5,
        "currency": "EUR"
      }
    },
    "updatedAt": "2026-06-10T09:15:31.000Z"
  },
  "remainder": {
    "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": 2,
    "graded": null,
    "forSale": false,
    "listing": null,
    "updatedAt": "2026-06-10T09:15:31.000Z"
  }
}

Line listed for sale.