Tournament Resource

All of the below documentation assumes that you have run the following in your python console first:

import limitless
limitless.api_token = "..."

Get list of tournaments

limitless.Tournament.list()

The list() function also supports the same parameters that are supported by the Limitless GET /tournaments endpoint:

# Using game param
limitless.Tournament.list(game="VGC")

# Using format param
limitless.Tournament.list(format="VGC23")

# Using limit param
limitless.Tournament.list(limit=100)

Sample Response

[
  {
    "id": "694c36244500833d870174af",
    "game": "POCKET",
    "name": "Storms Xmas Eve Faceoff-$5",
    "date": "2025-12-25T02:15:00.000Z",
    "format": null,
    "players": 113,
    "organizerId": 30
  },
  {
    "id": "6944549ce12a3ec47628a164",
    "game": "POCKET",
    "name": "Ericko x Soflo Circuit FULL ART 1-8th place!",
    "date": "2025-12-24T20:00:00.000Z",
    "format": null,
    "players": 195,
    "organizerId": 2505
  },
  {
    "id": "6945c037ba66621ba08a41c1",
    "game": "POCKET",
    "name": "MLA Crew 🎅 Adons XMAS Box (10 $ + FA SERENA)",
    "date": "2025-12-24T17:05:00.000Z",
    "format": null,
    "players": 284,
    "organizerId": 2487
  },
  # ...
]

Get tournament details

limitless.Tournament.get_details(id="64a347f1fa3294423e4e0d23")

Sample Response

{
  "id": "64a347f1fa3294423e4e0d23",
  "game": "VGC",
  "format": "VGC23",
  "name": "Nino Scarlet/Violet FF #70",
  "date": "2023-07-15T13:00:00.000Z",
  "players": 574,
  "organizer": {
    "id": 327,
    "name": "NinoPokeBros"
  },
  "platform": "SWITCH",
  "decklists": true,
  "isPublic": true,
  "isOnline": true,
  "phases": [
    {
      "phase": 1,
      "type": "SWISS",
      "rounds": 9,
      "mode": "BO3"
    },
    {
      "phase": 2,
      "type": "SWISS",
      "rounds": 5,
      "mode": "BO3"
    },
    {
      "phase": 3,
      "type": "SINGLE_BRACKET",
      "rounds": 1,
      "mode": "BO3"
    }
  ]
}

Get tournament standings

limitless.Tournament.get_standings(id="64a347f1fa3294423e4e0d23")

Sample Response

[
    {
        "name": "marcofiero",
        "country": "IT",
        "decklist": [
            {
                "id": "chien-pao",
                "name": "Chien-Pao",
                "item": "Focus Sash",
                "ability": "Sword of Ruin",
                "attacks": [
                    "Icicle Crash",
                    "Sucker Punch",
                    "Sacred Sword",
                    "Protect"
                ],
                "tera": "Ghost"
            },
            {
                "id": "dragonite",
                "name": "Dragonite",
                "item": "Choice Band",
                "ability": "Inner Focus",
                "attacks": [
                    "Stomping Tantrum",
                    "Extreme Speed",
                    "Aqua Jet",
                    "Aerial Ace"
                ],
                "tera": "Normal"
            },
            {
                "id": "urshifu-rapid-strike",
                "name": "Rapid Strike Urshifu",
                "item": "Choice Scarf",
                "ability": "Unseen Fist",
                "attacks": [
                    "Aqua Jet",
                    "Surging Strikes",
                    "Close Combat",
                    "Rock Slide"
                ],
                "tera": "Water"
            },
            {
                "id": "heatran",
                "name": "Heatran",
                "item": "Leftovers",
                "ability": "Flash Fire",
                "attacks": [
                    "Substitute",
                    "Heat Wave",
                    "Tera Blast",
                    "Protect"
                ],
                "tera": "Grass"
            },
            {
                "id": "flutter-mane",
                "name": "Flutter Mane",
                "item": "Booster Energy",
                "ability": "Protosynthesis",
                "attacks": [
                    "Dazzling Gleam",
                    "Shadow Ball",
                    "Protect",
                    "Moonblast"
                ],
                "tera": "Water"
            },
            {
                "id": "rillaboom",
                "name": "Rillaboom",
                "item": "Assault Vest",
                "ability": "Grassy Surge",
                "attacks": [
                    "Stomping Tantrum",
                    "Fake Out",
                    "Wood Hammer",
                    "U-turn"
                ],
                "tera": "Fire"
            }
        ],
        "placing": 1,
        "player": "marcofiero",
        "record": {
            "wins": 15,
            "losses": 2,
            "ties": 0
        },
        "deck": {},
        "drop": null
    },
    {
        "name": "MichaelderBeste",
        "country": "DE",
        "decklist": [
            {
                "id": "farigiraf",
                "name": "Farigiraf",
                "item": "Rocky Helmet",
                "ability": "Armor Tail",
                "attacks": [
                    "Psychic",
                    "Hyper Voice",
                    "Trick Room",
                    "Imprison"
                ],
                "tera": "Water"
            },
            {
                "id": "heatran",
                "name": "Heatran",
                "item": "Assault Vest",
                "ability": "Flash Fire",
                "attacks": [
                    "Heat Wave",
                    "Flash Cannon",
                    "Earth Power",
                    "Tera Blast"
                ],
                "tera": "Grass"
            },
            {
                "id": "chien-pao",
                "name": "Chien-Pao",
                "item": "Focus Sash",
                "ability": "Sword of Ruin",
                "attacks": [
                    "Icicle Crash",
                    "Crunch",
                    "Sucker Punch",
                    "Protect"
                ],
                "tera": "Dark"
            },
            {
                "id": "flutter-mane",
                "name": "Flutter Mane",
                "item": "Pixie Plate",
                "ability": "Protosynthesis",
                "attacks": [
                    "Moonblast",
                    "Dazzling Gleam",
                    "Substitute",
                    "Protect"
                ],
                "tera": "Fairy"
            },
            {
                "id": "rillaboom",
                "name": "Rillaboom",
                "item": "Sitrus Berry",
                "ability": "Grassy Surge",
                "attacks": [
                    "Wood Hammer",
                    "Stomping Tantrum",
                    "Fake Out",
                    "Protect"
                ],
                "tera": "Poison"
            },
            {
                "id": "dragapult",
                "name": "Dragapult",
                "item": "Choice Band",
                "ability": "Clear Body",
                "attacks": [
                    "Dragon Darts",
                    "Phantom Force",
                    "Tera Blast",
                    "U-turn"
                ],
                "tera": "Ghost"
            }
        ],
        "placing": 2,
        "player": "michaelderbeste",
        "record": {
            "wins": 14,
            "losses": 3,
            "ties": 0
        },
        "deck": {},
        "drop": null
    },
    # ...
]

Get tournament pairings

limitless.Tournament.get_pairings(id="64a347f1fa3294423e4e0d23")

Sample Response

[
    {'round': 1, 'phase': 1, 'table': None, 'winner': -1, 'player1': 'splattydaddy'},
    {'round': 1, 'phase': 1, 'table': None, 'winner': -1, 'player1': 'sheik'},
    {'round': 1, 'phase': 1, 'table': 276, 'winner': 'lushelldo', 'player1': 'lushelldo'},
    {'round': 1, 'phase': 1, 'table': 3, 'winner': 'ranghome', 'player1': 'ranghome', 'player2': 'raincandyluca'}
    # ...
]