Overview

TCG Plein Seller API

The TCG Plein API is a JSON REST API for sellers and their integrations: read the Pokémon TCG catalog (sets, cards, sealed products), manage your own listings, read and fulfil your orders, and receive webhook events. Every response is JSON; every request body you send is JSON.

Base URL

All endpoints live under a single versioned prefix. There is no unversioned base path; a breaking change gets a new version instead of altering v1 under your feet.

https://tcgplein.nl/api/v1

Machine-readable spec: the entire API surface is also published as an OpenAPI 3.1 document at https://tcgplein.nl/api/openapi.json, useful for generating a client or importing into API tooling.

What you can do

Area	What it's for
Catalog	Read-only: sets, cards and sealed products. Public data, no seller-specific scope required beyond `catalog:read`.
Listings	Create, update and delete your own listings in bulk.
Orders	Read incoming orders, generate shipping labels, mark orders shipped.
Webhooks	Register endpoints to receive order and listing events as they happen, instead of polling.
Me	A probe endpoint: confirms your key works and reports your scopes and rate limits.

Conventions

Fields are snake_case in both requests and responses.
Date-only fields (like a set's release date) are YYYY-MM-DD; timestamps are ISO 8601 (e.g. 2026-08-11T09:30:00+00:00).
List endpoints are paginated and return a data / links / meta envelope (see Pagination).
Every error, from a bad request to a rate limit, comes back as the same JSON shape (see Errors).

Quick start

Every authenticated request needs a Bearer API key. If you don't have one yet, start with Getting access. Once you have a key, GET /me is the first call to make: it confirms the key works and reports its scopes:

curl https://tcgplein.nl/api/v1/me \
  -H "Authorization: Bearer tcgp_live_K7mP2xQ9vZ4nR8wT3yL6bC1jD5sF0gH7uM2oA9iE"

<?php

$ch = curl_init('https://tcgplein.nl/api/v1/me');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer tcgp_live_K7mP2xQ9vZ4nR8wT3yL6bC1jD5sF0gH7uM2oA9iE',
]);

$response = curl_exec($ch);
curl_close($ch);

$me = json_decode($response, true);

const response = await fetch('https://tcgplein.nl/api/v1/me', {
  headers: {
    Authorization: 'Bearer tcgp_live_K7mP2xQ9vZ4nR8wT3yL6bC1jD5sF0gH7uM2oA9iE',
  },
});

const me = await response.json();

A working key returns your shop identity, granted scopes and effective rate limits. From there, Authentication covers key rotation and scopes, and Identifiers covers how sets, cards and products are addressed.