Get a list

​

Returns a single list of yours in full — its metadata and every card in it.

To enumerate your lists without their cards, see GET /v1/lists.

Requires the lists:read scope.

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

    The list's id, from GET /v1/lists or POST /v1/lists. Path parameter.

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

{
  "id": "6512a0b4e1d2c3f4a5b6c7d8",
  "name": "Modern deck — missing pieces",
  "game": "mtg",
  "status": "toComplete",
  "description": "Cards I still need for the Modern burn deck.",
  "bannerUrl": "https://ik.imagekit.io/cardnexus/production/mtg/mh2-137-front.png",
  "completionPercentage": 64,
  "itemCount": 2,
  "totalQuantity": 5,
  "isPublic": false,
  "currency": "USD",
  "defaultMinCondition": "NM",
  "defaultLanguage": "en",
  "createdAt": "2026-03-11T09:15:00.000Z",
  "updatedAt": "2026-06-28T14:02:47.000Z",
  "items": [
    {
      "id": "665f3a2b1c8d4e9f7a6b5c4d",
      "productId": 71044,
      "name": "Lightning Bolt",
      "nameSlug": "lightning-bolt",
      "expansion": "Modern Horizons 2",
      "finish": "Standard",
      "language": "en",
      "minCondition": "LP",
      "quantity": 4,
      "quantityFulfilled": 3,
      "wantPrice": 1.75,
      "sellPrice": null
    },
    {
      "id": "665f3a2b1c8d4e9f7a6b5c4e",
      "productId": 50212,
      "name": "Ragavan, Nimble Pilferer",
      "nameSlug": "ragavan-nimble-pilferer",
      "expansion": "Modern Horizons 2",
      "finish": "Foil",
      "language": "en",
      "minCondition": "NM",
      "quantity": 1,
      "quantityFulfilled": 0,
      "wantPrice": 60,
      "sellPrice": null
    }
  ]
}

List returned.