Sets
A set is a checklist of cards that came out together: an expansion, a promo series, a deck, a box. Each has one file with everything in it.
List a catalog's sets
GET /v1/sets/{catalog}.json returns every set of one catalog, era by era and then by release date. Each row is a short version of the set: enough to draw a list of sets with their logos without opening any set file.
The catalogs are english, japanese and zh-hans, and index.json lists them under catalogs. There is no file of every catalog's sets: for all of them, get each catalog's list. A set's language is the language its cards are printed in, which is its catalog's language.
curl https://pokemon.cardcorpus.com/v1/sets/english.json{
"catalog": "english",
"setCount": 324,
"sets": [
{
"id": "english/base-set",
"catalog": "english",
"name": "Base Set",
"type": "expansion",
"language": "en",
"cardCount": 102,
"released": { "date": "1999-01-09" },
"code": "BS",
"logo": "04b82b3dfb175c0fcaae417c841a2005",
"symbol": "beaedcca965c346c6ad9fc57e07480be",
// … 5 more fields
},
// … 323 more
]
}Get a set
GET /v1/sets/{id}.json returns the set with its cards. The id contains a slash (english/base-set); use it as it is.
logo and symbol are image ids. See Images for turning one into a url.
curl https://pokemon.cardcorpus.com/v1/sets/english/base-set.json{
"id": "english/base-set",
"catalog": "english",
"name": "Base Set",
"type": "expansion",
"language": "en",
"printedTotal": 102,
"cardCount": 102,
"released": { "date": "1999-01-09" },
"code": "BS",
"logo": "04b82b3dfb175c0fcaae417c841a2005",
"symbol": "beaedcca965c346c6ad9fc57e07480be",
"cards": [
{
"id": "1",
"name": "Alakazam",
// … 16 more fields
},
{
"id": "2",
"name": "Blastoise",
// … 16 more fields
},
// … 100 more
],
// … 7 more fields
}The set object
The fields most code needs come first. The rest cover print runs, links to related sets and the write-up.
idstringalways presentnamestringalways presentcatalogword from vocabulary.catalogalways presentlanguageword from vocabulary.languagealways presenttypeword from vocabulary.setTypealways presentreleasedobjectprintedTotalintegercardCountintegeralways presentcards; always present, 0 included.codestringlogopicture idsymbolpicture idcardslist of pointer13 more fields
englishNamestringalways presenterapointerpositionintegerlinepointeractualTotalintegerlinkCountintegerdescriptionobjecttellobjecttell stands in for it (see the guide).printRunslist of objectunlimited also stands for variants with no edition), each with what we say of it (see the guide).versionslist of objectonlyIn (see the guide).distributionslist of pointerbackImagepicture idlinkslist of pointer