Catalog

Sealed products

Read-only endpoints over sealed products: booster boxes, elite trainer boxes, tins, and similar. Both need the catalog:read scope. A sealed product's only id is its slug; see Identifiers.

List sealed products

GET /products

Query parameters

Parameter	Type	Required	Description
`q`	string	Optional	Search by product name.
`set`	string	Optional	A set identifier (canonical id or shortcut). Unlike sets and cards, this endpoint has no `?language=` / `?region=` parameters to disambiguate an ambiguous shortcut: if the shortcut you pass matches more than one set, the only way through is the set's canonical `tcg_api_id` instead.
`category`	string	Optional	Exact match, e.g. `elite_trainer_box`; the known categories are listed on Values. An unrecognized value is not rejected, it simply matches no rows and returns an empty page.
`page` / `per_page`	integer	Optional	See Pagination.

Response fields

Returns a paginated list of product objects:

Field	Type	Description
`id`	string	The product's slug, its only identifier.
`external_id`	string or null	Upstream catalog id, when known.
`name`	string	The product's name.
`category`	string	One of the categories listed on Values.
`release_year`	integer or null	Year of release.
`released_at`	string or null	`YYYY-MM-DD`, when the exact date is known.
`image`	string or null	Product image URL.
`url`	string	The product's page on the public marketplace.
`set`	object or null	The set the product is tied to (same set object as on Sets). Null for products without a specific set.

curl "https://tcgplein.nl/api/v1/products?set=sv1&category=elite_trainer_box" \
  -H "Authorization: Bearer tcgp_live_K7mP2xQ9vZ4nR8wT3yL6bC1jD5sF0gH7uM2oA9iE"

{
  "data": [
    {
      "id": "scarlet-violet-elite-trainer-box",
      "external_id": "sv1-etb",
      "name": "Scarlet & Violet Elite Trainer Box",
      "category": "elite_trainer_box",
      "release_year": 2023,
      "released_at": "2023-03-31",
      "image": "...",
      "url": "https://tcgplein.nl/producten/scarlet-violet-elite-trainer-box",
      "set": { "id": "sv1", "shortcut": "sv1", "name": "Scarlet Base", ... }
    }
  ],
  "links": { ... },
  "meta": { ... }
}

Get a sealed product

GET /products/{slug}

?include=listings embeds the product's active listings, the same unbounded, price-sorted embed described on Cards. There's no language / region parameter here either, since a sealed product isn't addressed by a friendly id at all.

Parameters

Parameter	Type	Required	Description
`{slug}`	string	Required	Path parameter: the product's slug.
`include`	string	Optional	Only `listings` is accepted.

Response fields

Returns a single product object under data:

Field	Type	Description
`id`	string	The product's slug, its only identifier.
`external_id`	string or null	Upstream catalog id, when known.
`name`	string	The product's name.
`category`	string	One of the categories listed on Values.
`release_year`	integer or null	Year of release.
`released_at`	string or null	`YYYY-MM-DD`, when the exact date is known.
`image`	string or null	Product image URL.
`url`	string	The product's page on the public marketplace.
`set`	object or null	The set the product is tied to (same set object as on Sets). Null for products without a specific set.
`listings`	array of objects	Only with `include=listings`: the product's active listings in the public listing shape documented on Listings.

curl "https://tcgplein.nl/api/v1/products/scarlet-violet-elite-trainer-box?include=listings" \
  -H "Authorization: Bearer tcgp_live_K7mP2xQ9vZ4nR8wT3yL6bC1jD5sF0gH7uM2oA9iE"

{
  "data": {
    "id": "scarlet-violet-elite-trainer-box",
    "name": "Scarlet & Violet Elite Trainer Box",
    "category": "elite_trainer_box",
    "listings": [
      { "id": 5190, "price": 44.95, "currency": "EUR", "quantity_available": 6, "seller": { "name": "CardShopNL", ... } }
    ]
  }
}