Public API reference

List games

GET /api/public/v1/games· API key required

Active catalog games only. Use each slug in paths below. Each entry includes isActive and optional imageUrl (same-origin proxy; append ?api_key= for <img src>), or null when no cover is set.

{
  "games": [
    {
      "slug": "cyberpunk-tcg",
      "name": "Cyberpunk TCG"
    },
    {
      "slug": "gundam",
      "name": "Gundam"
    },
    {
      "slug": "gundam-japan",
      "name": "Gundam Japan"
    },
    {
      "slug": "pokemon-tcg-pocket",
      "name": "Pokémon TCG Pocket"
    }
  ],
  "basePath": "/api/public/v1",
  "note": "Use each slug as the first path segment after v1 for game-scoped routes."
}

Current user (API key)

GET /api/public/v1/me· API key required

Illustrative values; call the endpoint with your key to see your user id, tier, and key metadata.

{
  "user": {
    "id": "cm4h2k3m0000abcd0000efgh",
    "name": "Alex Developer",
    "subscriptionTier": "BUILDER"
  },
  "key": {
    "id": "cm4h2k3m0000ijkl0000mnop",
    "prefix": "vt_live_a1b2",
    "name": "Staging"
  }
}

Game metadata

GET /api/public/v1/{gameSlug}· API key required

{
  "game": {
    "slug": "cyberpunk-tcg",
    "name": "Cyberpunk TCG",
    "createdAt": "2026-04-27T08:51:48.165Z",
    "updatedAt": "2026-05-05T20:33:41.755Z"
  },
  "routes": {
    "self": "/api/public/v1/cyberpunk-tcg",
    "prefix": "/api/public/v1/cyberpunk-tcg/",
    "priceReports": "/api/public/v1/cyberpunk-tcg/price-reports"
  }
}

List expansions

GET /api/public/v1/{gameSlug}/expansions· API key required

Ordered by release date (newest first), then name. Includes per-expansion card and sealed counts.

{
  "game": {
    "slug": "cyberpunk-tcg",
    "name": "Cyberpunk TCG"
  },
  "expansions": [
    {
      "slug": "alpha-kit-set",
      "name": "Alpha Kit Set",
      "nameEn": null,
      "nameJa": null,
      "code": "ALPHA-KIT",
      "releaseDate": null,
      "series": null,
      "imageUrl": null,
      "cardCount": 31,
      "sealedCount": 0,
      "createdAt": "2026-04-27T08:57:16.578Z",
      "updatedAt": "2026-05-05T20:21:32.407Z"
    },
    {
      "slug": "promo-cards",
      "name": "Promo Cards",
      "nameEn": null,
      "nameJa": null,
      "code": "PROMO",
      "releaseDate": null,
      "series": null,
      "imageUrl": null,
      "cardCount": 1,
      "sealedCount": 0,
      "createdAt": "2026-04-27T08:56:29.591Z",
      "updatedAt": "2026-05-05T20:49:38.761Z"
    },
    {
      "slug": "spoiler-set",
      "name": "Spoiler Set",
      "nameEn": null,
      "nameJa": null,
      "code": "SPOILER",
      "releaseDate": null,
      "series": null,
      "imageUrl": null,
      "cardCount": 20,
      "sealedCount": 0,
      "createdAt": "2026-04-27T08:55:54.724Z",
      "updatedAt": "2026-05-05T20:49:38.879Z"
    },
    {
      "slug": "welcome-to-night-city",
      "name": "Welcome To Night City",
      "nameEn": null,
      "nameJa": null,
      "code": "WtNC",
      "releaseDate": "2026-10-01",
      "series": null,
      "imageUrl": null,
      "cardCount": 0,
      "sealedCount": 3,
      "createdAt": "2026-04-27T10:17:37.320Z",
      "updatedAt": "2026-04-27T10:17:57.048Z"
    }
  ]
}

Sample above includes at most five expansions so the page stays readable; the live API returns the full list for the game.

One expansion

GET /api/public/v1/{gameSlug}/expansions/{expansionSlug}· API key required

routes points to the card list and sealed pricing path for this set.

{
  "game": {
    "slug": "cyberpunk-tcg",
    "name": "Cyberpunk TCG"
  },
  "expansion": {
    "slug": "alpha-kit-set",
    "name": "Alpha Kit Set",
    "nameEn": null,
    "nameJa": null,
    "code": "ALPHA-KIT",
    "releaseDate": null,
    "series": null,
    "imageUrl": null,
    "cardCount": 31,
    "sealedCount": 0,
    "createdAt": "2026-04-27T08:57:16.578Z",
    "updatedAt": "2026-05-05T20:21:32.407Z"
  },
  "routes": {
    "self": "/api/public/v1/cyberpunk-tcg/expansions/alpha-kit-set",
    "expansionPrefix": "/api/public/v1/cyberpunk-tcg/expansions/alpha-kit-set/",
    "cards": "/api/public/v1/cyberpunk-tcg/expansions/alpha-kit-set/cards",
    "sealedProductPricing": "/api/public/v1/cyberpunk-tcg/expansions/alpha-kit-set/sealed/{sealedSlug}"
  }
}

List cards in an expansion

GET /api/public/v1/{gameSlug}/expansions/{expansionSlug}/cards· API key required

Omits cards marked excludeFromPublicPricing. Default payload: every card’s id, slug, name, primary imageUrl, and updatedAt in one JSON response (no pagination). Query include (comma-separated, case-insensitive):

• cardData or shorthand full — full cardData plus all imageUrls per card. Large sets can produce very large JSON.
• marketPricing or shorthand pricing — ebayLastSolds and conditionPrices per card for non-Free tiers (empty on Free). Response may include include.marketPricingPopulated so clients can tell whether pricing arrays were filled.

Example: ?include=cardData,marketPricing. Advanced (PRO) / ENTERPRISE also receive description fields on list rows when the heavier payload is requested (same rules as card detail).

{
  "game": {
    "slug": "cyberpunk-tcg",
    "name": "Cyberpunk TCG"
  },
  "expansion": {
    "slug": "alpha-kit-set",
    "name": "Alpha Kit Set"
  },
  "cards": [
    {
      "id": "cmot3ru7z00ssf451xfawgddy",
      "slug": "goro-takemura-foil-a030",
      "name": "Goro Takemura",
      "imageUrl": null,
      "updatedAt": "2026-05-05T20:50:43.007Z"
    },
    {
      "id": "cmot3ru9800stf451drqgmaiw",
      "slug": "saburo-arasaka-foil-a029",
      "name": "Saburo Arasaka",
      "imageUrl": null,
      "updatedAt": "2026-05-05T20:50:43.052Z"
    },
    {
      "id": "cmot3ruaf00suf451ubi0flyy",
      "slug": "yorinobu-arasaka-foil-a031",
      "name": "Yorinobu Arasaka",
      "imageUrl": null,
      "updatedAt": "2026-05-05T20:50:43.095Z"
    },
    {
      "id": "cmot3tli700svf451c59bqxl5",
      "slug": "armored-minotaur-a007",
      "name": "Armored Minotaur",
      "imageUrl": null,
      "updatedAt": "2026-05-05T20:52:05.023Z"
    },
    {
      "id": "cmot3tljc00swf4515hqb8c5a",
      "slug": "corpo-security-a016",
      "name": "Corpo Security",
      "imageUrl": null,
      "updatedAt": "2026-05-05T20:52:05.064Z"
    }
  ],
  "routes": {
    "self": "/api/public/v1/cyberpunk-tcg/expansions/alpha-kit-set/cards",
    "cardDetail": "/api/public/v1/cyberpunk-tcg/expansions/alpha-kit-set/cards/{cardId}"
  }
}

Sample lists at most five cards; the API returns every in-catalog card for the expansion (excluding items marked private to pricing).

Example: replace {cardId} with the id from this list (cuid), not the slug.

Card detail (with pricing)

GET /api/public/v1/{gameSlug}/expansions/{expansionSlug}/cards/{cardId}· API key required

cardData is game-specific JSON (numbers, variants, language fields, etc.). Cards excluded from public pricing return 404. routes includes list, listWithCardData, and, when your tier and game support it, refreshPricing.

{
  "game": {
    "slug": "cyberpunk-tcg",
    "name": "Cyberpunk TCG"
  },
  "expansion": {
    "slug": "alpha-kit-set",
    "name": "Alpha Kit Set"
  },
  "card": {
    "id": "cmot3ru7z00ssf451xfawgddy",
    "slug": "goro-takemura-foil-a030",
    "name": "Goro Takemura",
    "imageUrls": [],
    "cardData": {
      "ram": 2,
      "code": "a030",
      "cost": 5,
      "type": "Legend",
      "power": 7,
      "rules": "GO SOLO (Pay this card's cost to play it as a ready unit. It can attack this turn.) BLOCKER (When a rival units attacks, you may spend this unit to redirect the attack to this unit.)",
      "colour": "Green",
      "keywords": "GO SOLO,BLOCKER",
      "subtitle": "Hands Unclean",
      "expansion": "alpha-kit-set",
      "illustrator": "Vincenzo Riccardi",
      "variantName": "Foil",
      "classification": "Arasaka,Corpo"
    },
    "updatedAt": "2026-05-05T20:50:43.007Z",
    "catalogCardDescription": {
      "set": {
        "name": "Alpha Kit Set",
        "slug": "alpha-kit-set",
        "code": "ALPHA-KIT",
        "series": null,
        "releaseDate": null,
        "nameEn": null
      },
      "history": null,
      "playableInOfficialTcg": null,
      "playableExplanation": null,
      "simpleDescription": null
    },
    "enterpriseCatalogDescription": null
  },
  "ebayLastSolds": [],
  "conditionPrices": [],
  "routes": {
    "self": "/api/public/v1/cyberpunk-tcg/expansions/alpha-kit-set/cards/cmot3ru7z00ssf451xfawgddy",
    "list": "/api/public/v1/cyberpunk-tcg/expansions/alpha-kit-set/cards"
  }
}

basis is either avg_last_3d (average of non-outlier sales in the recent window) or latest_sale when there is not enough in-window data.

Sealed product (with pricing)

GET /api/public/v1/{gameSlug}/expansions/{expansionSlug}/sealed/{sealedSlug}· API key required

The sealed item must be linked to this expansion. Slug is the catalog sealed slug for that game. Same ebayLastSolds / conditionPrices shape as cards.

Sealed product sample appears when a sealed item linked to the sample expansion exists in the catalog.