Values
Every fixed value list the API accepts or returns, in one place. These tables are rendered from the
same definitions the API validates against, so they always match the live behaviour. Sending a value
outside these lists gets a 422 validation_error (see
Errors).
Languages
Used as a listing's language field (required on
POST /listings), as a set's
language, and as the language filter on the catalog
endpoints.
| Value | Label |
|---|---|
EN |
English |
NL |
Nederlands |
DE |
Deutsch |
FR |
Français |
JP |
日本語 |
ES |
Español |
IT |
Italiano |
PT |
Português |
CN |
中文 |
KR |
한국어 |
Conditions
A card listing's condition field, required for every card item on
POST /listings. Sealed-product listings have no
condition (null in responses). When you send G
(Graded), grading_company and grading_grade become
required too.
| Value | Label |
|---|---|
M |
Mint |
NM |
Near Mint |
LP |
Lightly Played |
MP |
Moderately Played |
HP |
Heavily Played |
DMG |
Damaged |
G |
Graded |
Grading companies and grades
grading_company on a graded listing, and graded.company
in listing responses.
| Value | Label |
|---|---|
PSA |
PSA |
BGS |
Beckett (BGS) |
CGC |
CGC |
SGC |
SGC |
TAG |
TAG |
GRAAD |
GRAAD |
ACE |
ACE Grading |
PCA |
PCA |
OVERIG |
Overig |
grading_grade accepts these values, always written with one decimal
(10.0 down to 1.0 in half steps):
10.0 9.5 9.0 8.5 8.0 7.5 7.0 6.5 6.0 5.5 5.0 4.5 4.0 3.5 3.0 2.5 2.0 1.5 1.0
Printings
A card listing's optional printing field (the card's variant). Omitting it on
POST /listings means
standard; sealed-product listings have no printing.
| Value | Label |
|---|---|
standard |
Standard |
reverse_holo |
Reverse Holo |
holo |
Holo |
first_edition |
1st Edition |
shadowless |
Shadowless |
full_art |
Full Art |
alternate_art |
Alternate Art |
promo |
Promo |
Sealed product categories
A sealed product's category field, and the category
filter on GET /products. Labels are the
(Dutch-language) names shown on the marketplace itself.
| Value | Label |
|---|---|
elite_trainer_box |
Elite Trainer Boxen |
booster_box |
Boosterboxen |
booster_bundle |
Booster Bundles |
booster_pack |
Boosterpacks |
premium_collection |
Collection Boxen |
tin |
Tins |
mini_tin |
Mini Tins |
theme_deck |
Thema Decks |
build_battle_box |
Build & Battle Boxen |
special_collection |
Speciale collectie |
cases |
Cases & Displays |
other |
Overig |
Listing statuses
A listing's status field: the status filter on
GET /listings, the writable
status on PATCH /listings/{id}, and the owner-only
status in listing responses.
| Value | Description |
|---|---|
active |
Live and buyable on the marketplace. |
sold |
Out of stock. Restocking via a quantity update flips it back to active automatically. |
hidden |
Temporarily hidden by you. Not visible or buyable, but keeps its stock. |
A fourth status, removed, exists internally as a takedown state but is never
returned or accepted by the seller API.
Order statuses
An order row's status field, and the status filter on
GET /orders.
| Value | Description |
|---|---|
pending |
Paid, waiting for you to ship. |
shipped |
You marked it shipped. |
received |
The buyer confirmed receipt (or the confirmation window auto-closed). |
cancelled |
Cancelled and refunded. |
disputed |
The buyer opened a dispute. Resolved by TCG Plein. |
Cancellation reasons
The cancelled_by field in the order.cancelled webhook
payload (see Webhooks).
| Value | Description |
|---|---|
buyer |
The buyer cancelled the order. |
seller |
You cancelled the order. |
admin |
TCG Plein cancelled it, typically as a dispute resolution. |
system |
Cancelled automatically, e.g. when a seller never completed payout onboarding. |
Seller tiers
The seller_tier field on GET /me
and the seller.tier field on every listing. Tiers are recalculated monthly
from sales volume; a higher tier pays a lower commission.
| Value | Commission |
|---|---|
Bronze |
5% |
Silver |
4.5% |
Gold |
4% |
Diamond |
3.5% |
Master |
3% |
Webhook events
The event names accepted by POST /webhooks and sent in every delivery's
event field. Full payload examples for each event are on
Webhooks.
| Value | Description |
|---|---|
order.created |
A checkout created an order row for one of your listings. |
order.cancelled |
An order row was cancelled and refunded. |
order.label_ready |
A shipping label was generated, or its tracking barcode arrived. |
listing.sold |
A listing sold (fires alongside order.created for the same sale). |
API key scopes
The scopes a key can be issued with (see
Authentication). They also appear in the
scopes array on GET /me.
| Value | Description |
|---|---|
catalog:read |
Read sets, cards and sealed products. |
listings:read |
List your own listings. |
listings:write |
Create, update and delete your own listings. |
orders:read |
Read your orders. |
orders:write |
Generate shipping labels and mark orders shipped. |
webhooks:manage |
Register, list and remove webhook endpoints. |
Series shortcuts
Curated community-style codes accepted by the series filter on
GET /sets as an alternative to the full series name.
GET /series returns the live list, including series without a shortcut.
| Value | Series |
|---|---|
base |
Base |
gym |
Gym |
neo |
Neo |
ecard |
E-Card |
ex |
EX |
np |
NP |
pop |
POP |
dp |
Diamond & Pearl |
pl |
Platinum |
hgss |
HeartGold & SoulSilver |
cp |
Champion Pack |
bw |
Black & White |
xy |
XY |
sm |
Sun & Moon |
swsh |
Sword & Shield |
sv |
Scarlet & Violet |
me |
Mega Evolution |
wc |
World Championships |