List cards in an expansion

GET /api/v1/azuki/expansions/{id}/cards read:catalog 1 credit

Page through one expansion’s cards. Equivalent to searching cards with `expansion.id:{id}`, but scoped by path so you can’t accidentally widen the query. Accepts the same `q`, `orderBy`, `distinct`, paging and `include` params. `language` is honoured but NOT defaulted here: an expansion id already names a language (`EB01` vs `EB01_ja`), so an English default would empty every Japanese set.

Try it GET /api/v1/azuki/expansions/sv3pt5/cards?page_size=10&include=prices

These inputs are shared across all docs pages, so an id entered here carries over.

response
200 31ms preloaded server-side with the default context
object · 6 keys
{
  "success": true,
  "data": [
    {
      "id": "AZK01-071",
      "name": "Alley Fetchduck",
      "number": "071",
      "printed_number": "071",
      "images": [
        {
          "type": "front",
          "small": "https://static-content.azuki.com/tcg/card_art/S1-AZK01-071_Alley-Fetchduck_E_UC_die.jpg",
          "medium": "https://static-content.azuki.com/tcg/card_art/S1-AZK01-071_Alley-Fetchduck_E_UC_die.jpg",
          "large": "https://static-content.azuki.com/tcg/card_art/S1-AZK01-071_Alley-Fetchduck_E_UC_die.jpg"
        }
      ],
      "expansion": {
        "id": "azk-01",
        "name": "Gates Awakened",
        "total": 154,
        "language": "English",
        "language_code": "en",
        "series": "Azuki TCG",
        "code": "AZK-01",
        "printed_total": 129,
        "release_date": "2026/06/29",
        "logo": "https://tcg.azuki.com/azuki_tcg_logo.svg",
        "symbol": "https://tcg.azuki.com/azuki_tcg_logo.svg"
      },
      "language": "English",
      "language_code": "en",
      "tcgplayer_id": null,
      "variants": [
        {
          "name": "normal",
          "images": [
            {
              "type": "front",
              "small": "https://static-content.azuki.com/tcg/card_art/S1-AZK01-071_Alley-Fetchduck_E_UC_die.jpg",
              "medium": "https://static-content.azuki.com/tcg/card_art/S1-AZK01-071_Alley-Fetchduck_E_UC_die.jpg",
              "large": "https://static-content.azuki.com/tcg/card_art/S1-AZK01-071_Alley-Fetchduck_E_UC_die.jpg"
            }
          ]
        }
      ],
      "supertype": "Entity",
      "subtypes": [
        "Bird"
      ],
      "types": [
        "Neutral"
      ],
      "hp": "2",
      "rarity": "Uncommon",
      "pricing": {
        "currency": "USD",
        "market": null,
        "is_stale": false,
        "conditions": [],
        "graded": []
      }
    },
    {
      "id": "AZK01-004",
      "name": "Alley Thug",
      "number": "004",
      "printed_number": "004",
      "images": [
        {
          "type": "front",
          "small": "https://static-content.azuki.com/tcg/card_art/S1-AZK01-004_Alley-Thug_E_C_die.jpg",
          "medium": "https://static-content.azuki.com/tcg/card_art/S1-AZK01-004_Alley-Thug_E_C_die.jpg",
          "large": "https://static-content.azuki.com/tcg/card_art/S1-AZK01-004_Alley-Thug_E_C_die.jpg"
        }
      ],
      "expansion": {
        "id": "azk-01",
        "name": "Gates Awakened",
        "total": 154,
        "language": "English",
        "language_code": "en",
        "series": "Azuki TCG",
        "code": "AZK-01",
        "printed_total": 129,
        "release_date": "2026/06/29",
        "logo": "https://tcg.azuki.com/azuki_tcg_logo.svg",
        "symbol": "https://tcg.azuki.com/azuki_tcg_logo.svg"
      },
      "language": "English",
      "language_code": "en",
      "tcgplayer_id": null,
      "variants": [
        {
          "name": "normal",
          "images": [
            {
              "type": "front",
              "small": "https://static-content.azuki.com/tcg/card_art/S1-AZK01-004_Alley-Thug_E_C_die.jpg",
              "medium": "https://static-content.azuki.com/tcg/card_art/S1-AZK01-004_Alley-Thug_E_C_die.jpg",
              "large": "https://static-content.azuki.com/tcg/card_art/S1-AZK01-004_Alley-Thug_E_C_die.jpg"
            }
          ]
        }
      ],
      "supertype": "Entity",
      "subtypes": [
        "Alley Dweller",
        "Dawnling"
      ],
      "types": [
        "Neutral"
      ],
      "hp": "1",
      "rarity": "Common",
      "pricing": {
        "currency": "USD",
        "market": null,
        "is_stale": false,
        "conditions": [],
        "graded": []
      }
    },
    {
      "id": "AZK01-029",
      "name": "Aquatic Veil",
      "number": "029",
      "printed_number": "029",
      "images": [
        {
          "type": "front",
          "small": "https://static-content.azuki.com/tcg/card_art/S1-AZK01-029_Aquatic-Veil_S_R_die.jpg",
          "medium": "https://static-content.azuki.com/tcg/card_art/S1-AZK01-029_Aquatic-Veil_S_R_die.jpg",
          "large": "https://static-content.azuki.com/tcg/card_art/S1-AZK01-029_Aquatic-Veil_S_R_die.jpg"
        }
      ],
      "expansion": {
        "id": "azk-01",
        "name": "Gates Awakened",
        "total": 154,
        "language": "English",
        "language_code": "en",
        "series": "Azuki TCG",
        "code": "AZK-01",
        "printed_total": 129,
        "release_date": "2026/06/29",
        "logo": "https://tcg.azuki.com/azuki_tcg_logo.svg",
        "symbol": "https://tcg.azuki.com/azuki_tcg_logo.svg"
      },
      "language": "English",
      "language_code": "en",
      "tcgplayer_id": null,
      "variants": [
        {
          "name": "normal",
          "images": [
            {
              "type": "front",
              "small": "https://static-content.azuki.com/tcg/card_art/S1-AZK01-029_Aquatic-Veil_S_R_die.jpg",
              "medium": "https://static-content.azuki.com/tcg/card_art/S1-AZK01-029_Aquatic-Veil_S_R_die.jpg",
              "large": "https://static-content.azuki.com/tcg/card_art/S1-AZK01-029_Aquatic-Veil_S_R_die.jpg"
            }
          ]
        }
      ],
      "supertype": "Spell",
      "subtypes": [
        "Aquashield"
      ],
      "types": [
        "Water"
      ],
      "rarity": "Rare",
      "pricing": {
        "currency": "USD",
        "market": null,
        "is_stale": false,
        "conditions": [],
        "graded": []
      }
    },
    {
      "id": "AZK01-098",
      "name": "Arms Dealer, Kin",
      "number": "098",
      "printed_number": "098",
      "images": [
        {
          "type": "front",
          "small": "https://static-content.azuki.com/tcg/card_art/S1-AZK01-098_Arms-Dealer-Kin_E_C_die.jpg",
          "medium": "https://static-content.azuki.com/tcg/card_art/S1-AZK01-098_Arms-Dealer-Kin_E_C_die.jpg",
          "large": "https://static-content.azuki.com/tcg/card_art/S1-AZK01-098_Arms-Dealer-Kin_E_C_die.jpg"
        }
      ],
      "expansion": {
        "id": "azk-01",
        "name": "Gates Awakened",
        "total": 154,
        "language": "English",
        "language_code": "en",
        "series": "Azuki TCG",
        "code": "AZK-01",
        "printed_total": 129,
        "release_date": "2026/06/29",
        "logo": "https://tcg.azuki.com/azuki_tcg_logo.svg",
        "symbol": "https://tcg.azuki.com/azuki_tcg_logo.svg"
      },
      "language": "English",
      "language_code": "en",
      "tcgplayer_id": null,
      "variants": [
        {
          "name": "normal",
          "images": [
            {
              "type": "front",
              "small": "https://static-content.azuki.com/tcg/card_art/S1-AZK01-098_Arms-Dealer-Kin_E_C_die.jpg",
              "medium": "https://static-content.azuki.com/tcg/card_art/S1-AZK01-098_Arms-Dealer-Kin_E_C_die.jpg",
              "large": "https://static-content.azuki.com/tcg/card_art/S1-AZK01-098_Arms-Dealer-Kin_E_C_die.jpg"
            }
          ]
        }
      ],
      "supertype": "Entity",
      "subtypes": [
        "Merchant",
        "Steelborn"
      ],
      "types": [
        "Lightning"
      ],
      "hp": "2",
      "rarity": "Common",
      "pricing": {
        "currency": "USD",
        "market": null,
        "is_stale": false,
        "conditions": [],
        "graded": []
      }
    },
    {
      "id": "AZK01-118",
      "name": "Bandit Ringleader",
      "number": "118",
      "printed_number": "118",
      "images": [
        {
          "type": "front",
          "small": "https://static-content.azuki.com/tcg/card_art/S1-AZK01-118_Bandit-Ringleader_E_C_die.jpg",
          "medium": "https://static-content.azuki.com/tcg/card_art/S1-AZK01-118_Bandit-Ringleader_E_C_die.jpg",
          "large": "https://static-content.azuki.com/tcg/card_art/S1-AZK01-118_Bandit-Ringleader_E_C_die.jpg"
        }
      ],
      "expansion": {
        "id": "azk-01",
        "name": "Gates Awakened",
        "total": 154,
        "language": "English",
        "language_code": "en",
        "series": "Azuki TCG",
        "code": "AZK-01",
        "printed_total": 129,
        "release_date": "2026/06/29",
        "logo": "https://tcg.azuki.com/azuki_tcg_logo.svg",
        "symbol": "https://tcg.azuki.com/azuki_tcg_logo.svg"
      },
      "language": "English",
      "language_code": "en",
      "tcgplayer_id": null,
      "variants": [
        {
          "name": "normal",
          "images": [
            {
              "type": "front",
              "small": "https://static-content.azuki.com/tcg/card_art/S1-AZK01-118_Bandit-Ringleader_E_C_die.jpg",
              "medium": "https://static-content.azuki.com/tcg/card_art/S1-AZK01-118_Bandit-Ringleader_E_C_die.jpg",
              "large": "https://static-content.azuki.com/tcg/card_art/S1-AZK01-118_Bandit-Ringleader_E_C_die.jpg"
            }
          ]
        }
      ],
      "supertype": "Entity",
      "subtypes": [
        "Bandit",
        "Scorchweaver"
      ],
      "types": [
        "Fire"
      ],
      "hp": "2",
      "rarity": "Common",
      "pricing": {
        "currency": "USD",
        "market": null,
        "is_stale": false,
        "conditions": [],
        "graded": []
      }
    },
    {
      "id": "AZK01-072",
      "name": "Beanz Mentor",
      "number": "072",
      "printed_number": "072",
      "images": [
        {
          "type": "front",
          "small": "https://static-content.azuki.com/tcg/card_art/S1-AZK01-072_Beanz-Mentor_E_R_die.jpg",
          "medium": "https://static-content.azuki.com/tcg/card_art/S1-AZK01-072_Beanz-Mentor_E_R_die.jpg",
          "large": "https://static-content.azuki.com/tcg/card_art/S1-AZK01-072_Beanz-Mentor_E_R_die.jpg"
        }
      ],
      "expansion": {
        "id": "azk-01",
        "name": "Gates Awakened",
        "total": 154,
        "language": "English",
        "language_code": "en",
        "series": "Azuki TCG",
        "code": "AZK-01",
        "printed_total": 129,
        "release_date": "2026/06/29",
        "logo": "https://tcg.azuki.com/azuki_tcg_logo.svg",
        "symbol": "https://tcg.azuki.com/azuki_tcg_logo.svg"
      },
      "language": "English",
      "language_code": "en",
      "tcgplayer_id": null,
      "variants": [
        {
          "name": "normal",
          "images": [
            {
              "type": "front",
              "small": "https://static-content.azuki.com/tcg/card_art/S1-AZK01-072_Beanz-Mentor_E_R_die.jpg",
              "medium": "https://static-content.azuki.com/tcg/card_art/S1-AZK01-072_Beanz-Mentor_E_R_die.jpg",
              "large": "https://static-content.azuki.com/tcg/card_art/S1-AZK01-072_Beanz-Mentor_E_R_die.jpg"
            }
          ]
        }
      ],
      "supertype": "Entity",
      "subtypes": [
        "Beanz",
        "Elder"
      ],
      "types": [
        "Neutral"
      ],
      "hp": "1",
      "rarity": "Rare",
      "pricing": {
        "currency": "USD",
        "market": null,
        "is_stale": false,
        "conditions": [],
        "graded": []
      }
    },
    {
      "id": "AZK01-125",
      "name": "Benzai the Sly",
      "number": "125",
      "printed_number": "125",
      "images": [
        {
          "type": "front",
          "small": "https://static-content.azuki.com/tcg/card_art/S1-AZK01-125_Benzai-the-Sly_L_L_die.jpg",
          "medium": "https://static-content.azuki.com/tcg/card_art/S1-AZK01-125_Benzai-the-Sly_L_L_die.jpg",
          "large": "https://static-content.azuki.com/tcg/card_art/S1-AZK01-125_Benzai-the-Sly_L_L_die.jpg"
        }
      ],
      "expansion": {
        "id": "azk-01",
        "name": "Gates Awakened",
        "total": 154,
        "language": "English",
        "language_code": "en",
        "series": "Azuki TCG",
        "code": "AZK-01",
        "printed_total": 129,
        "release_date": "2026/06/29",
        "logo": "https://tcg.azuki.com/azuki_tcg_logo.svg",
        "symbol": "https://tcg.azuki.com/azuki_tcg_logo.svg"
      },
      "language": "English",
      "language_code": "en",
      "tcgplayer_id": null,
      "variants": [
        {
          "name": "normal",
          "images": [
            {
              "type": "front",
              "small": "https://static-content.azuki.com/tcg/card_art/S1-AZK01-125_Benzai-the-Sly_L_L_die.jpg",
              "medium": "https://static-content.azuki.com/tcg/card_art/S1-AZK01-125_Benzai-the-Sly_L_L_die.jpg",
              "large": "https://static-content.azuki.com/tcg/card_art/S1-AZK01-125_Benzai-the-Sly_L_L_die.jpg"
            }
          ]
        }
      ],
      "supertype": "Leader",
      "subtypes": [
        "Frog",
        "Merchant",
        "Watercrafting"
      ],
      "types": [
        "Water"
      ],
      "hp": "20",
      "rarity": "Leader",
      "pricing": {
        "currency": "USD",
        "market": null,
        "is_stale": false,
        "conditions": [],
        "graded": []
      }
    },
    {
      "id": "AZK01-125A",
      "name": "Benzai the Sly",
      "number": "125A",
      "printed_number": "125A",
      "images": [
        {
          "type": "front",
          "small": "https://static-content.azuki.com/tcg/card_art/S1-AZK01-125A_Benzai-the-Sly_L_L_die.jpg",
          "medium": "https://static-content.azuki.com/tcg/card_art/S1-AZK01-125A_Benzai-the-Sly_L_L_die.jpg",
          "large": "https://static-content.azuki.com/tcg/card_art/S1-AZK01-125A_Benzai-the-Sly_L_L_die.jpg"
        }
      ],
      "expansion": {
        "id": "azk-01",
        "name": "Gates Awakened",
        "total": 154,
        "language": "English",
        "language_code": "en",
        "series": "Azuki TCG",
        "code": "AZK-01",
        "printed_total": 129,
        "release_date": "2026/06/29",
        "logo": "https://tcg.azuki.com/azuki_tcg_logo.svg",
        "symbol": "https://tcg.azuki.com/azuki_tcg_logo.svg"
      },
      "language": "English",
      "language_code": "en",
      "tcgplayer_id": null,
      "variants": [
        {
          "name": "normal",
          "images": [
            {
              "type": "front",
              "small": "https://static-content.azuki.com/tcg/card_art/S1-AZK01-125A_Benzai-the-Sly_L_L_die.jpg",
              "medium": "https://static-content.azuki.com/tcg/card_art/S1-AZK01-125A_Benzai-the-Sly_L_L_die.jpg",
              "large": "https://static-content.azuki.com/tcg/card_art/S1-AZK01-125A_Benzai-the-Sly_L_L_die.jpg"
            }
          ]
        }
      ],
      "supertype": "Leader",
      "subtypes": [
        "Frog",
        "Merchant",
        "Watercrafting"
      ],
      "types": [
        "Water"
      ],
      "hp": "20",
      "rarity": "Leader ★",
      "pricing": {
        "currency": "USD",
        "market": null,
        "is_stale": false,
        "conditions": [],
        "graded": []
      }
    },
    {
      "id": "AZK01-082",
      "name": "Black Jade Brawler",
      "number": "082",
      "printed_number": "082",
      "images": [
        {
          "type": "front",
          "small": "https://static-content.azuki.com/tcg/card_art/S1-AZK01-082_Black-Jade-Brawler_E_UC_die.jpg",
          "medium": "https://static-content.azuki.com/tcg/card_art/S1-AZK01-082_Black-Jade-Brawler_E_UC_die.jpg",
          "large": "https://static-content.azuki.com/tcg/card_art/S1-AZK01-082_Black-Jade-Brawler_E_UC_die.jpg"
        }
      ],
      "expansion": {
        "id": "azk-01",
        "name": "Gates Awakened",
        "total": 154,
        "language": "English",
        "language_code": "en",
        "series": "Azuki TCG",
        "code": "AZK-01",
        "printed_total": 129,
        "release_date": "2026/06/29",
        "logo": "https://tcg.azuki.com/azuki_tcg_logo.svg",
        "symbol": "https://tcg.azuki.com/azuki_tcg_logo.svg"
      },
      "language": "English",
      "language_code": "en",
      "tcgplayer_id": null,
      "variants": [
        {
          "name": "normal",
          "images": [
            {
              "type": "front",
              "small": "https://static-content.azuki.com/tcg/card_art/S1-AZK01-082_Black-Jade-Brawler_E_UC_die.jpg",
              "medium": "https://static-content.azuki.com/tcg/card_art/S1-AZK01-082_Black-Jade-Brawler_E_UC_die.jpg",
              "large": "https://static-content.azuki.com/tcg/card_art/S1-AZK01-082_Black-Jade-Brawler_E_UC_die.jpg"
            }
          ]
        }
      ],
      "supertype": "Entity",
      "subtypes": [
        "Black Jade",
        "Brawler",
        "Steelborn"
      ],
      "types": [
        "Neutral"
      ],
      "hp": "2",
      "abilities": [
        {
          "name": "Charge",
          "text": "",
          "type": "ability"
        }
      ],
      "rarity": "Uncommon",
      "pricing": {
        "currency": "USD",
        "market": null,
        "is_stale": false,
        "conditions": [],
        "graded": []
      }
    },
    {
      "id": "AZK01-003",
      "name": "Black Jade Courier",
      "number": "003",
      "printed_number": "003",
      "images": [
        {
          "type": "front",
          "small": "https://static-content.azuki.com/tcg/card_art/S1-AZK01-003_Black-Jade-Courier_E_C_die.jpg",
          "medium": "https://static-content.azuki.com/tcg/card_art/S1-AZK01-003_Black-Jade-Courier_E_C_die.jpg",
          "large": "https://static-content.azuki.com/tcg/card_art/S1-AZK01-003_Black-Jade-Courier_E_C_die.jpg"
        }
      ],
      "expansion": {
        "id": "azk-01",
        "name": "Gates Awakened",
        "total": 154,
        "language": "English",
        "language_code": "en",
        "series": "Azuki TCG",
        "code": "AZK-01",
        "printed_total": 129,
        "release_date": "2026/06/29",
        "logo": "https://tcg.azuki.com/azuki_tcg_logo.svg",
        "symbol": "https://tcg.azuki.com/azuki_tcg_logo.svg"
      },
      "language": "English",
      "language_code": "en",
      "tcgplayer_id": null,
      "variants": [
        {
          "name": "normal",
          "images": [
            {
              "type": "front",
              "small": "https://static-content.azuki.com/tcg/card_art/S1-AZK01-003_Black-Jade-Courier_E_C_die.jpg",
              "medium": "https://static-content.azuki.com/tcg/card_art/S1-AZK01-003_Black-Jade-Courier_E_C_die.jpg",
              "large": "https://static-content.azuki.com/tcg/card_art/S1-AZK01-003_Black-Jade-Courier_E_C_die.jpg"
            }
          ]
        }
      ],
      "supertype": "Entity",
      "subtypes": [
        "Black Jade",
        "Strider"
      ],
      "types": [
        "Neutral"
      ],
      "hp": "1",
      "rarity": "Common",
      "pricing": {
        "currency": "USD",
        "market": null,
        "is_stale": false,
        "conditions": [],
        "graded": []
      }
    }
  ],
  "page": 1,
  "page_size": 10,
  "total_count": 154,
  "language": "all"
}
tracks the inputs above
curl -X GET 'https://service.rip.fun/api/v1/azuki/expansions/sv3pt5/cards?page_size=10&include=prices' \
  -H 'X-API-Key: rip_…'

Request fields

FieldTypeRequiredDescription
qstringAdvanced search, e.g. `name:char*`, `(subtypes:mega OR subtypes:vmax)`, `-types:water`, `hp:[150 TO *]`, `expansion.id:sv1`; on One Piece, the gameplay fields too — `colors:Black cost:[1 TO 3] type:Character`. Capped at 512 characters, 20 terms and 5 levels of parentheses — a generated filter reaches those long before a hand-typed one does. Unknown fields return 400 with a suggestion. Full grammar + field list: see the Search & filtering guide.
languagestringLanguage code, or a comma list. **Defaults to `en`**: every card exists once per printed language, so an unfiltered list interleaves two catalogs. Pass `language=all` for every language, or `language=ja`. The applied value comes back in the envelope. A `language:`, `id:` or `expansion.id:` term in `q` already pins the language, so the default steps aside.
orderBystringComma list; `-` prefix = DESC, e.g. `-release_date`. Max 3 keys. Cards sort on `name`, `number`, `rarity`, `raw_price`/`market_price`, `release_date`, `expansion.id`, `id` (plus `hp` on Pokémon and `cost`, `power`, `counter`, `life` on One Piece). Missing values sort LAST in both directions, and every sort carries a unique `id` tiebreak, so paging a sorted result set can neither skip nor repeat a row.
distinctstringSet to `code` to return one row per card rather than one per printing, and to make `total_count` count cards. Without it a page of 30 is ~17 cards and a code whose printings straddle a page boundary appears on both. The row kept is the base printing; filters that vary BETWEEN printings of a code (`rarity`, `raw_price`, `is_holo`) do not combine with it — every gameplay field does.
page / page_sizenumberPagination. `page` ≥ 1 (default 1), `page_size` 1–100 (default 100, `pageSize` also accepted). Out-of-range values are rejected, never clamped. `page × page_size` capped at 10,000, so narrow with `q` to go deeper. Always compare `total_count` against the rows you received — 100 is a cap, not a promise, and a truncated page looks identical to a complete one. Collections you might assume fit in a single call do not: there are more than 100 One Piece expansions, so an unpaginated `/expansions` omits the newest sets and everything you would have walked from them.
selectstringComma list of top-level fields to keep (`id` always included). Trims response size and does not change the credit cost.
includestringSet to `prices` to embed the pricing object on every returned object. **No surcharge** — metering is a flat 1 credit per request whatever the response carries, so hydrating a page of 100 with prices costs the same as without, and strictly less than a second call per row.

Response fields (data)

FieldDescription
data[].idCard id (variant printings carry a suffix, e.g. `…vh` for holofoil, `…vrh` for reverse holofoil)
data[].name / supertype / subtypesCard identity + classification
data[].rarity / number / printed_number / artistPrint metadata
data[].images[]`{ type, small, medium, large }`, `type` always `front`. Use `small` for grids and `large` for detail views. Two caveats: `medium` is always an alias of `large` (only two sizes are stored), and on cards whose source supplied a single rendition `small` is an alias too — it points at the same file as `large`. Compare the two URLs before assuming `small` is cheap; where they differ it is roughly 6× smaller.
data[].language / language_codeCard language: `English`/`en`. Each printing is its own object.
data[].tcgplayer_idTCGplayer product id for cross-referencing, or null when we don’t have one
data[].expansionNested expansion object (id, name, series, total, release_date, logo, symbol, …)
data[].variants[]`{ name, images[] }`, one self-describing element per card printing
data[].pricingPresent only with `include=prices` — and then always present, even where we hold nothing: `market` comes back `null` and the two arrays empty rather than the key being dropped. `{ currency, market, market_updated_at, is_stale, trend_7d, conditions[], graded[] }`, with every amount a **number** rather than a decimal string. `trend_7d` is `{ direction, percent }`, and it is the only trend window there is. See the Pricing data guide.
data[].pricing.conditions[]`{ condition, price }` raw ladder (NM/LP/MP/HP/DMG) for the card’s variant — those two fields only
data[].pricing.graded[]Reconciled graded value per company+grade: `{ company, grade, value, low, high, confidence, value_kind, sold_count, trend? }`

Errors

StatusCodeWhen
400parse_errormalformed `q` syntax: an unclosed quote or parenthesis, a missing term, a stray operator. `details.position` is the 0-based character offset of the offending token.
400unknown_fielda `q` term names a field this resource does not register (`subtype:` for `subtypes:`, a card field on `/sealed`), or `orderBy` names a field you cannot sort on. The message carries a did-you-mean suggestion and `details.position` points at it. Unknown fields are rejected, never ignored — an empty page would be the more expensive answer.
400invalid_valuethe field exists but the value does not fit it: a range on a field that has no ordering, a non-numeric bound, a value outside a closed vocabulary.
400query_too_complex`q` exceeds 512 characters, 20 terms or 5 levels of parenthesis nesting, `orderBy` names more than 3 keys, or a value breaks the wildcard guardrails (a leading `*`, more than 3 per value, fewer than 2 literal characters). Filter builders hit this before people do — count terms as you assemble, and fall back to several narrower calls rather than one wide one.
400invalid_pagination`page`/`page_size` non-numeric, out of range, or `page × page_size` > 10,000
400invalid_language`language` is not a language code — expected `en`, `ja`, a comma list of codes, or `all`
400invalid_distinct`distinct` is anything other than `code`
400invalid_select`select` names more than 40 fields. Names that do not exist are ignored rather than rejected, so a typo silently drops the field — check the response, not just the status.
400invalid_include`include` carries a value this endpoint does not offer. Cards and sealed accept `prices`; the expansion endpoints accept none at all.
404not_foundno such object for this game (a Pokémon id on `/onepiece` is "not found")

See Errors for the response envelope and the full code list.