Limitless Docs

Games

All endpoints are relative to https://play.limitlesstcg.com/api.

GET /games

Returns an array of all the games that are supported on the site.

Response Format

FieldTypeDescription
idStringAbbreviation/ID that is used to identify the game throughout the site.
nameStringDisplay name that's used for the game.
formatsMapAbbreviation/ID <-> Name pairs of all the formats that can be selected to play the game in.
platformsMapAbbreviation/ID <-> Name pairs of all the platforms that can be selected to play the game on.
metagameBooleanIndicates whether the game has automatic deck categorization and metagame stats.

Example Response 

[
    {
        "id": "PTCG",
        "name": "Pokémon TCG",
        "formats": { ... },
        "platforms": {
            "PTCGL": "Pokémon TCG Live",
            "PTCGO": "Pokémon TCG Online",
            ...
        },
        "metagame": true
    },
    ...
]

Example Use Cases

  • Getting the full names of all the game, format and platform IDs used in tournament endpoints.
  • Listing all the supported options / filters.

GET /games/{id}/decks

If the game supports automatic deck categorization, this endpoint returns the rules that are used. Note that existing rules may be updated or even deleted at any time.

Response Format

FieldTypeDescription
identifierStringuniquely identifies the deck
nameStringA display name that does not need to be unique.
cardsObject[]An array of cards that need to be in the decklist for it to be categorized as this deck.
→ countNumbermin. number of copies of the card in the decklist (1 if empty)
→ nameString(exact!) name of the card
→ setStringSet code of the card, if there are different ones with the same name.
→ numberStringSet number of the card, if there are different ones with the same name & set.
priorityNumberOrder in which the rules should be applied (defaults to 10, higher number is checked after).
variantsObject[]Further rules by which the deck can be categorized more specifically if it matches the top-level rules. Sub-identifiers should be unique among all decks and variants so that they can also be used on the top level.
iconsString[]If available (Pokémon TCG), icons used to represent the deck type.
generationNumberUsed to group decks together by timeframe (optional).

Example Response 

[
    {
        "identifier": "jolteon-vmax",
        "name": "Jolteon",
        "icons": [
            "jolteon"
        ],
        "priority": 10,
        "cards": [
            {
                "name": "Jolteon VMAX",
                "count": "2"
            }
        ],
        "variants": [
            {
                "identifier": "jolteon-inteleon",
                "name": "Jolteon Inteleon",
                "icon": "inteleon",
                "cards": [
                    {
                        "name": "Drizzile",
                        "count": "2"
                    },
                    {
                        "name": "Inteleon"
                    }
                ]
            }
        ],
        "generation": 8
    },
    ...
]

Example Use Cases

  • Updating deck categorization of past tournaments without re-downloading all tournament data.
  • Customizing deck categorization rules without re-doing them from scratch.

Last Updated: