New

Field Catalog

Browse flexible metadata fields (Artist, HP, Rarity, Mana Cost) and see how widely each one is used across the catalog

What This Does

Lists every field defined across the catalog — Pokémon HP, Magic Mana Cost, trading-card Artist, Rarity, and more
Shows usageCount per field — the number of cards, sets, releases, and segments that carry a value for it
Sorts by name or usageCount and filters by a search query
Returns a single field in detail via /catalog/fields/{id}
Powers cross-TCG metadata search — one surface for every game, no per-game branching

When To Use This

Discovering what metadata exists for non-sports cards (Pokémon, Magic, One Piece, Yu-Gi-Oh)
Building filter UIs that adapt to whichever fields are relevant for the current segment
Sanity-checking field coverage before pushing a report or dashboard
Looking up a field ID to reference in other API calls
Educating users about what flexible metadata is available on identify / search results

Real Example

Scenario

You browse the most-used fields in the catalog to see what metadata collectors can filter on

Sample Request

GET

/v1/catalog/fields?sort=usageCount&order=desc&take=20

What You Get Back

{
  "fields": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "key": "ARTIST",
      "name": "Artist",
      "description": "Illustrator credited on the card",
      "usageCount": 48231
    },
    {
      "id": "550e8400-e29b-41d4-a716-446655440001",
      "key": "RARITY",
      "name": "Rarity",
      "description": "Rarity tier (Common, Uncommon, Rare, Holo Rare, etc.)",
      "usageCount": 39104
    },
    {
      "id": "550e8400-e29b-41d4-a716-446655440002",
      "key": "HP",
      "name": "Hit Points",
      "description": "Base HP value on Pokémon cards",
      "usageCount": 11520
    }
  ],
  "total_count": 58,
  "skip": 0,
  "take": 20
}