/api/v1/azuki/cards read:catalog 1
creditSearch every Azuki TCG card we have. Leave `q` empty to page through the whole catalog, or use the Lucene-style query grammar to filter on any indexed field. Wrapped in `{ success, data, page, page_size, total_count, language }`.
GET /api/v1/azuki/cards?page_size=10&include=prices These inputs are shared across all docs pages, so an id entered here carries over.
{
"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": "STT01-007",
"name": "Alley Guy",
"number": "007",
"printed_number": "007",
"images": [
{
"type": "front",
"small": "https://static-content.azuki.com/tcg/card_art/S1-STT01-007_Alley-Guy_E_C_die.jpg",
"medium": "https://static-content.azuki.com/tcg/card_art/S1-STT01-007_Alley-Guy_E_C_die.jpg",
"large": "https://static-content.azuki.com/tcg/card_art/S1-STT01-007_Alley-Guy_E_C_die.jpg"
}
],
"expansion": {
"id": "azk-stt-01",
"name": "Gates Awakened Starter Deck: Raizan (Lightning)",
"total": 19,
"language": "English",
"language_code": "en",
"series": "Azuki TCG",
"code": "STT-01",
"printed_total": 17,
"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-STT01-007_Alley-Guy_E_C_die.jpg",
"medium": "https://static-content.azuki.com/tcg/card_art/S1-STT01-007_Alley-Guy_E_C_die.jpg",
"large": "https://static-content.azuki.com/tcg/card_art/S1-STT01-007_Alley-Guy_E_C_die.jpg"
}
]
}
],
"supertype": "Entity",
"subtypes": [
"Alley Dweller",
"Dawnling"
],
"types": [
"Neutral"
],
"hp": "2",
"rarity": "Common",
"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": "STT01-005",
"name": "Alpine Prowler",
"number": "005",
"printed_number": "005",
"images": [
{
"type": "front",
"small": "https://static-content.azuki.com/tcg/card_art/S1-STT01-005_Alpine-Prowler_E_C_die.jpg",
"medium": "https://static-content.azuki.com/tcg/card_art/S1-STT01-005_Alpine-Prowler_E_C_die.jpg",
"large": "https://static-content.azuki.com/tcg/card_art/S1-STT01-005_Alpine-Prowler_E_C_die.jpg"
}
],
"expansion": {
"id": "azk-stt-01",
"name": "Gates Awakened Starter Deck: Raizan (Lightning)",
"total": 19,
"language": "English",
"language_code": "en",
"series": "Azuki TCG",
"code": "STT-01",
"printed_total": 17,
"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-STT01-005_Alpine-Prowler_E_C_die.jpg",
"medium": "https://static-content.azuki.com/tcg/card_art/S1-STT01-005_Alpine-Prowler_E_C_die.jpg",
"large": "https://static-content.azuki.com/tcg/card_art/S1-STT01-005_Alpine-Prowler_E_C_die.jpg"
}
]
}
],
"supertype": "Entity",
"subtypes": [
"Bandit"
],
"types": [
"Lightning"
],
"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": "STT02-009",
"name": "Aya",
"number": "009",
"printed_number": "009",
"images": [
{
"type": "front",
"small": "https://static-content.azuki.com/tcg/card_art/S1-STT02-009_Aya_E_C_die.jpg",
"medium": "https://static-content.azuki.com/tcg/card_art/S1-STT02-009_Aya_E_C_die.jpg",
"large": "https://static-content.azuki.com/tcg/card_art/S1-STT02-009_Aya_E_C_die.jpg"
}
],
"expansion": {
"id": "azk-stt-02",
"name": "Gates Awakened Starter Deck: Shao (Water)",
"total": 19,
"language": "English",
"language_code": "en",
"series": "Azuki TCG",
"code": "STT-02",
"printed_total": 17,
"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-STT02-009_Aya_E_C_die.jpg",
"medium": "https://static-content.azuki.com/tcg/card_art/S1-STT02-009_Aya_E_C_die.jpg",
"large": "https://static-content.azuki.com/tcg/card_art/S1-STT02-009_Aya_E_C_die.jpg"
}
]
}
],
"supertype": "Entity",
"subtypes": [
"Painter",
"Watercrafting"
],
"types": [
"Water"
],
"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": "STT02-007",
"name": "Benzai the Merchant",
"number": "007",
"printed_number": "007",
"images": [
{
"type": "front",
"small": "https://static-content.azuki.com/tcg/card_art/S1-STT02-007_Benzai-the-Merchant_E_C_die.jpg",
"medium": "https://static-content.azuki.com/tcg/card_art/S1-STT02-007_Benzai-the-Merchant_E_C_die.jpg",
"large": "https://static-content.azuki.com/tcg/card_art/S1-STT02-007_Benzai-the-Merchant_E_C_die.jpg"
}
],
"expansion": {
"id": "azk-stt-02",
"name": "Gates Awakened Starter Deck: Shao (Water)",
"total": 19,
"language": "English",
"language_code": "en",
"series": "Azuki TCG",
"code": "STT-02",
"printed_total": 17,
"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-STT02-007_Benzai-the-Merchant_E_C_die.jpg",
"medium": "https://static-content.azuki.com/tcg/card_art/S1-STT02-007_Benzai-the-Merchant_E_C_die.jpg",
"large": "https://static-content.azuki.com/tcg/card_art/S1-STT02-007_Benzai-the-Merchant_E_C_die.jpg"
}
]
}
],
"supertype": "Entity",
"subtypes": [
"Frog",
"Merchant",
"Wavecaller"
],
"types": [
"Water"
],
"hp": "2",
"rarity": "Common",
"pricing": {
"currency": "USD",
"market": null,
"is_stale": false,
"conditions": [],
"graded": []
}
}
],
"page": 1,
"page_size": 10,
"total_count": 237,
"language": "en"
}curl -X GET 'https://service.rip.fun/api/v1/azuki/cards?page_size=10&include=prices' \ -H 'X-API-Key: rip_…'
| Field | Type | Required | Description |
|---|---|---|---|
q | string | — | Advanced 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. |
language | string | — | Language 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. |
orderBy | string | — | Comma 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. |
distinct | string | — | Set 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_size | number | — | Pagination. `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. |
select | string | — | Comma list of top-level fields to keep (`id` always included). Trims response size and does not change the credit cost. |
include | string | — | Set 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. |
data)| Field | Description |
|---|---|
data[].id | Card id (variant printings carry a suffix, e.g. `…vh` for holofoil, `…vrh` for reverse holofoil) |
data[].name / supertype / subtypes | Card identity + classification |
data[].rarity / number / printed_number / artist | Print 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_code | Card language: `English`/`en`. Each printing is its own object. |
data[].tcgplayer_id | TCGplayer product id for cross-referencing, or null when we don’t have one |
data[].expansion | Nested expansion object (id, name, series, total, release_date, logo, symbol, …) |
data[].variants[] | `{ name, images[] }`, one self-describing element per card printing |
data[].pricing | Present 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? }` |
Game fields on the Card object, on top of the shared ones above. All are optional and are omitted when we have no value, so a missing key means unknown.
| Field | What it holds |
|---|---|
supertype | The card’s category — what the game calls its Card Type: Entity, Leader, Gate, IKZ, Spell or Weapon. Ingested into the shared `supertype` column, so it arrives under that name rather than a `category` of its own. |
types | A one-element array holding the card’s Element: Fire, Water, Earth, Lightning or Neutral. Same overloading — one Azuki concept riding a Pokémon-shaped column. |
subtypes | Printed traits, verbatim from the official gallery. |
hp | Health, as a string, and emitted only when greater than zero — the 72 cards that print no Health at all (Gates, IKZ, Spells) carry no key rather than a `"0"`. Health is the only one of the four printed numbers you get: Attack, IKZ cost and Gate power have no column to ride and are not returned. |
abilities | `{ type, name, text }` per printed ability, but only `name` carries information: the gallery publishes ability names without their rules text, so `text` is always the empty string and `type` is always `"ability"`. Do not render the empty text as "no effect". |
rarity | The expanded label rather than the printed code: Common, Uncommon, Rare, Super Rare, Leader, Gate, IKZ, each optionally starred — `Super Rare ★` is an alt art and `★★` a portrait rare. The short code (`SR ★`) is stored but not returned. |
number | The number after the group prefix, and the printing letter is part of it: `AZK01-106A` numbers `106A`, where Pokémon and One Piece put the printing in the id suffix and leave the number alone. Range queries (`number:[1 TO 50]`) compare the leading digits. |
These values are printed on the physical card but no endpoint returns them today, and nothing in the response lets you derive them. Don't infer them — see the notes below.
| Field | Why it's missing |
|---|---|
ikz_cost / attack / gate_power | Three of the four numbers printed on the card (Health is the fourth, and is returned as `hp`). All three are ingested and sit on the row, but no field registry exposes them, so no endpoint emits them and no `q` key filters on them. |
card_text | The printed rules paragraph. Ingested, not serialized. `abilities[].name` is the only rules-adjacent string you get, and it is a name, not an effect. |
errata / errata_before / errata_after | The published correction for a card, and its before/after text. Ingested, not serialized — so the API cannot tell you a card has been errata’d. |
printed_in | Every set a printing appears in. A card can ship in the booster and a starter deck; the response carries only its home `expansion`, so a set’s cards endpoint under-reports shared printings. |
rarity_code | The gallery’s short code (`SR ★`). Only the expanded label is returned; map back yourself if you need the code. |
artist | Azuki publishes no illustrator credits, so the column is empty and the key is omitted — absent here means unpublished, not unknown to us. |
Each concept filters under the name it comes back as — that is the Query as column, and the one to write today. Also accepts is an older
spelling from when q resolved only against physical columns; it still
works, and a — there just means the field never had one. A concept whose Query as is — is not searchable at all; filter it client-side
after fetching. Querying an unknown field returns 400 invalid_query with a
suggested name rather than an empty result.
| Concept | Returned as | Query as | Also accepts |
|---|---|---|---|
| Element | types | types:Fire | — |
| Card type | supertype | supertype:Gate | — |
| Trait | subtypes | subtypes:Beanz | — |
| Health | hp | hp:[5 TO *] | — |
| Rarity | rarity | rarity:"Super Rare ★" | — |
| Ability name | abilities[].name | abilities.name:Charge | — |
| Ability text | — | — | — |
| IKZ cost | — | — | — |
| Attack | — | — | — |
| Gate power | — | — | — |
Every game field is optional and is omitted rather than sent as null, so a missing key means unknown — not zero and not empty.
There are no Azuki prices, and there is no date by which there will be. No marketplace has a TCGplayer or Scrydex catalog for AZK-01 and no sold comps exist, so nothing feeds the pricing engine: every card stores a raw price of 0.00, which the API reports as `pricing.market: null` rather than a $0 card, and no card has a `trend_7d`. Do not build a price chart, a portfolio value or a "biggest movers" list on Azuki — it will be a chart of zeros, and it will not fill in on its own.
The six sealed products are the exception, and only just. Each carries the MSRP its distributor published, flagged `price_basis: "msrp"` on the row, and it reaches you as `msrp` — never as `pricing.market`, which stays `null`. That split is deliberate: a list price echoed back under a `market` key would chart as a flat line indistinguishable from a real one, so there is no market figure to plot, no `trend_7d`, and no meaningful "vs MSRP" premium. Show the MSRP as an MSRP, or not at all.
`images[].small` is the same URL as `large` on every Azuki card — the gallery publishes one rendition per card and we store it in both columns. Resize on your side rather than pulling a full-size file into a grid.
Four of the seven sets are starter decks, and their sealed products come back as `product_type: "other"` rather than a `starter_deck` value, which does not exist — the product enum has no member for it and One Piece’s 64 starter decks are filed the same way. Match on the product name if you need to separate them.
Alt arts do not stay in their base card’s set: a starter-deck leader’s alt art is a booster pull, and four `AZK01-*` alt arts exist only in the Alpha run. A variant hunt scoped to one expansion will miss most of them — search the game, not the set.
| Status | Code | When |
|---|---|---|
| 400 | parse_error | malformed `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. |
| 400 | unknown_field | a `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. |
| 400 | invalid_value | the 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. |
| 400 | query_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. |
| 400 | invalid_pagination | `page`/`page_size` non-numeric, out of range, or `page × page_size` > 10,000 |
| 400 | invalid_language | `language` is not a language code — expected `en`, `ja`, a comma list of codes, or `all` |
| 400 | invalid_distinct | `distinct` is anything other than `code` |
| 400 | invalid_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. |
| 400 | invalid_include | `include` carries a value this endpoint does not offer. Cards and sealed accept `prices`; the expansion endpoints accept none at all. |
| 404 | not_found | no 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.