Random Booster API

Generate random booster packs for trading card games. Free, open, no authentication required.

Supported Games

Magic: The Gathering Pokémon Yu-Gi-Oh! Lorcana One Piece Flesh and Blood KARDS

Base URL

https://open.randombooster.de

Endpoints

GET /v1/games

List all supported games.

GET /v1/games/{game}/sets

List all available sets for a game.

GET /v1/games/{game}/sets/{set_code}

Get detailed information about a specific set (release date, size, available products).

GET /v1/games/{game}/sets/{set_code}/products/{booster_type}?amount={n}

Generate random booster packs. Returns a box with n boosters (default 3, max configurable).

POST /v1/games/magic/images

Look up image URLs for Magic cards by Scryfall ID. Body: {"scryfallIds": ["uuid", ...]} (max 500).

Quick Example

1. List games

GET /v1/games

Response:
[
  {"name": "Magic: The Gathering", "key": "magic"},
  {"name": "Pokémon", "key": "pokemon"},
  ...
]

2. List sets for a game

GET /v1/games/magic/sets

Response:
[
  {"code": "woe", "name": "Wilds of Eldraine", "products": ["play", "draft", "collector"]},
  ...
]

3. Open boosters

GET /v1/games/magic/sets/woe/products/draft?amount=2

Response:
{
  "game": {"name": "Magic: The Gathering"},
  "set": {"name": "Wilds of Eldraine", "kind": "expansion"},
  "box": {
    "uuid": "...",
    "productionDate": "2026-05-19",
    "content": [
      {
        "uuid": "...",
        "kind": "draft",
        "cards": [
          {"id": 1, "uuid": "...", "name": "...", "imageUrl": "...", "rarity": "common", "foil": false},
          ...
        ]
      },
      ...
    ]
  }
}
Tips: