cardcorpus

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
  ]
}
200application/json, cut down here to the fields this page covers

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
}
200application/json, cut down here to the fields this page covers

The set object

The fields most code needs come first. The rest cover print runs, links to related sets and the write-up.

idstringalways present
The set's id. Treat it as opaque: it never changes once published.
namestringalways present
The set's name as it prints it, in its language. Where no source gives the printed name yet, its English name (see the guide).
catalogword from vocabulary.catalogalways present
The catalog the set belongs to.
languageword from vocabulary.languagealways present
The language its cards are printed in: its catalog's, apart from a box like the Pikachu World Collection, which holds cards in several (see the guide).
typeword from vocabulary.setTypealways present
What the set is, by how its cards reached people.
releasedobject
When the set came out came out, as precisely as is known (see the guide).
printedTotalinteger
The total its card numbers print (the 102 of 4/102), where they print one.
cardCountintegeralways present
How many cards the set has in its cards; always present, 0 included.
codestring
The set code it prints.
logopicture id
Its logo.
symbolpicture id
The set symbol, the small mark its cards print (an icon a source gives for a set that prints none).
cardslist of pointer
Every card, in number order.
13 more fields
englishNamestringalways present
The set's name in English, on every set: "Expansion Pack (Base Set)" (see the guide).
erapointer
Its era, by pointer, which stays when the era is renamed.
positioninteger
Its place among its catalog's sets of one release date, where the data orders them.
linepointer
The line the set is one part of, where several of our sets came out as one product or range of products (see the guide).
actualTotalinteger
How many cards the set has by its own count, secret cards included, where known.
linkCountinteger
How many links the set has to other sets; always present, 0 included.
descriptionobject
What we wrote about the set, for people to read, and the pages it draws on (see the guide).
tellobject
How to tell this set's print of a card from other sets' prints of the same painting, in a few words, naming only what every card of the set prints (its symbol, its numbering), with the pages that back it; a card's own tell stands in for it (see the guide).
printRunslist of object
The set's print runs whose place is known, earliest first, by edition (unlimited also stands for variants with no edition), each with what we say of it (see the guide).
versionslist of object
The versions the set's product was sold in, earliest first, where the version decides some of the cards in it (pack designs of a set sold in waves, binders of two colours); a card found in only some names them in its own onlyIn (see the guide).
distributionslist of pointer
How every variant of the set was handed out, where all came out one way (a Prize Pack series, a Burger King collection), named once here and not on each variant (see the guide).
backImagepicture id
The back every card of the set shares, where that is unlike the usual one (a World Championships Deck's).
linkslist of pointer
The set's links to other sets.