/api/v1/pokemon/sealed read:catalog 1
creditSearch sealed Pokémon Trading Card Game product — booster packs and boxes, elite trainer boxes, bundles, blisters, tins and collection boxes — with the same query grammar as cards, over the sealed field set. Every product hangs off an expansion, so `expansion.id:…` is the usual way in. Wrapped in `{ success, data, page, page_size, total_count, language }`.
GET /api/v1/pokemon/sealed?page_size=10&include=prices These inputs are shared across all docs pages, so an id entered here carries over.
{
"success": true,
"data": [
{
"id": "fut20-1mcs",
"name": "11th Movie Commemoration Set",
"expansion": {
"id": "fut20",
"name": "Miscellaneous Cards & Products",
"total": 5,
"language": "English",
"language_code": "en",
"series": "Other",
"code": "FUT20",
"printed_total": 5,
"release_date": "2020/09/11",
"logo": "https://api.rip.fun/storage/v1/object/public/avatars/sets/fut20/logo-1774920080320.png",
"symbol": "https://gjnrvwqtdlspyfpezgox.supabase.co/storage/v1/object/public/tcg/sets/fut20.symbol.png"
},
"language": "English",
"language_code": "en",
"images": [
{
"type": "front",
"small": "https://api.rip.fun/storage/v1/object/public/tcg/products/fut20/fut20-1mcs.png",
"medium": "https://api.rip.fun/storage/v1/object/public/tcg/products/fut20/fut20-1mcs.png",
"large": "https://api.rip.fun/storage/v1/object/public/tcg/products/fut20/fut20-1mcs.png"
}
],
"product_type": "other",
"release_date": "2020/09/11",
"tcgplayer_id": "266001",
"pricing": {
"currency": "USD",
"market": 439.67,
"is_on_sale": false,
"updated_at": "2026-05-09T00:13:19.732Z",
"trend_7d": {
"direction": "flat",
"percent": 0
}
}
},
{
"id": "sv3pt5-1aec",
"name": "151 Alakazam ex Collection",
"expansion": {
"id": "sv3pt5",
"name": "151",
"total": 207,
"language": "English",
"language_code": "en",
"series": "Scarlet & Violet",
"code": "MEW",
"printed_total": 165,
"release_date": "2023/09/22",
"logo": "https://gjnrvwqtdlspyfpezgox.supabase.co/storage/v1/object/public/tcg/sets/sv3pt5.logo.png",
"symbol": "https://gjnrvwqtdlspyfpezgox.supabase.co/storage/v1/object/public/tcg/sets/sv3pt5.symbol.png"
},
"language": "English",
"language_code": "en",
"images": [
{
"type": "front",
"small": "https://api.rip.fun/storage/v1/object/public/tcg/products/sv3pt5/sv3pt5-1aec.small.webp",
"medium": "https://api.rip.fun/storage/v1/object/public/tcg/products/sv3pt5/sv3pt5-1aec.large.webp",
"large": "https://api.rip.fun/storage/v1/object/public/tcg/products/sv3pt5/sv3pt5-1aec.large.webp"
}
],
"product_type": "collection_box",
"release_date": "2023/09/22",
"tcgplayer_id": "502006",
"pricing": {
"currency": "USD",
"market": 118.21,
"is_on_sale": false,
"updated_at": "2026-09-21T00:13:29.515Z",
"trend_7d": {
"direction": "flat",
"percent": -0.01
}
}
},
{
"id": "sv3pt5-aec",
"name": "151: Alakazam ex Collection",
"expansion": {
"id": "sv3pt5",
"name": "151",
"total": 207,
"language": "English",
"language_code": "en",
"series": "Scarlet & Violet",
"code": "MEW",
"printed_total": 165,
"release_date": "2023/09/22",
"logo": "https://gjnrvwqtdlspyfpezgox.supabase.co/storage/v1/object/public/tcg/sets/sv3pt5.logo.png",
"symbol": "https://gjnrvwqtdlspyfpezgox.supabase.co/storage/v1/object/public/tcg/sets/sv3pt5.symbol.png"
},
"language": "English",
"language_code": "en",
"images": [
{
"type": "front",
"small": "https://api.rip.fun/storage/v1/object/public/tcg/products/sv3pt5/sv3pt5-aec.png",
"medium": "https://api.rip.fun/storage/v1/object/public/tcg/products/sv3pt5/sv3pt5-aec.png",
"large": "https://api.rip.fun/storage/v1/object/public/tcg/products/sv3pt5/sv3pt5-aec.png"
}
],
"product_type": "other",
"release_date": "2023/09/22",
"tcgplayer_id": "502006",
"pricing": {
"currency": "USD",
"market": 118.35,
"is_on_sale": false,
"updated_at": "2026-09-21T00:13:29.515Z",
"trend_7d": {
"direction": "flat",
"percent": 0.28
}
}
},
{
"id": "sv3pt5-1bc",
"name": "151 Binder Collection",
"expansion": {
"id": "sv3pt5",
"name": "151",
"total": 207,
"language": "English",
"language_code": "en",
"series": "Scarlet & Violet",
"code": "MEW",
"printed_total": 165,
"release_date": "2023/09/22",
"logo": "https://gjnrvwqtdlspyfpezgox.supabase.co/storage/v1/object/public/tcg/sets/sv3pt5.logo.png",
"symbol": "https://gjnrvwqtdlspyfpezgox.supabase.co/storage/v1/object/public/tcg/sets/sv3pt5.symbol.png"
},
"language": "English",
"language_code": "en",
"images": [
{
"type": "front",
"small": "https://api.rip.fun/storage/v1/object/public/tcg/products/sv3pt5/sv3pt5-1bc.png",
"medium": "https://api.rip.fun/storage/v1/object/public/tcg/products/sv3pt5/sv3pt5-1bc.png",
"large": "https://api.rip.fun/storage/v1/object/public/tcg/products/sv3pt5/sv3pt5-1bc.png"
}
],
"product_type": "other",
"release_date": "2023/09/22",
"tcgplayer_id": "502004",
"pricing": {
"currency": "USD",
"market": 229.8,
"is_on_sale": false,
"updated_at": "2026-09-21T00:13:29.515Z",
"trend_7d": {
"direction": "down",
"percent": -0.61
}
}
},
{
"id": "sv3pt5-1bcc",
"name": "151 Binder Collection Case",
"expansion": {
"id": "sv3pt5",
"name": "151",
"total": 207,
"language": "English",
"language_code": "en",
"series": "Scarlet & Violet",
"code": "MEW",
"printed_total": 165,
"release_date": "2023/09/22",
"logo": "https://gjnrvwqtdlspyfpezgox.supabase.co/storage/v1/object/public/tcg/sets/sv3pt5.logo.png",
"symbol": "https://gjnrvwqtdlspyfpezgox.supabase.co/storage/v1/object/public/tcg/sets/sv3pt5.symbol.png"
},
"language": "English",
"language_code": "en",
"images": [
{
"type": "front",
"small": "https://api.rip.fun/storage/v1/object/public/tcg/products/sv3pt5/sv3pt5-1bcc.png",
"medium": "https://api.rip.fun/storage/v1/object/public/tcg/products/sv3pt5/sv3pt5-1bcc.png",
"large": "https://api.rip.fun/storage/v1/object/public/tcg/products/sv3pt5/sv3pt5-1bcc.png"
}
],
"product_type": "other",
"release_date": "2023/09/22",
"tcgplayer_id": "502003",
"pricing": {
"currency": "USD",
"market": 1247.45,
"is_on_sale": false,
"updated_at": "2026-09-17T23:16:24.895Z",
"trend_7d": {
"direction": "flat",
"percent": -0.2
}
}
},
{
"id": "sv3pt5-1bb",
"name": "151 Booster Bundle",
"expansion": {
"id": "sv3pt5",
"name": "151",
"total": 207,
"language": "English",
"language_code": "en",
"series": "Scarlet & Violet",
"code": "MEW",
"printed_total": 165,
"release_date": "2023/09/22",
"logo": "https://gjnrvwqtdlspyfpezgox.supabase.co/storage/v1/object/public/tcg/sets/sv3pt5.logo.png",
"symbol": "https://gjnrvwqtdlspyfpezgox.supabase.co/storage/v1/object/public/tcg/sets/sv3pt5.symbol.png"
},
"language": "English",
"language_code": "en",
"images": [
{
"type": "front",
"small": "https://api.rip.fun/storage/v1/object/public/tcg/products/sv3pt5/sv3pt5-1bb.png",
"medium": "https://api.rip.fun/storage/v1/object/public/tcg/products/sv3pt5/sv3pt5-1bb.png",
"large": "https://api.rip.fun/storage/v1/object/public/tcg/products/sv3pt5/sv3pt5-1bb.png"
}
],
"product_type": "bundle",
"release_date": "2023/09/22",
"tcgplayer_id": "502000",
"pricing": {
"currency": "USD",
"market": 162.91,
"is_on_sale": false,
"updated_at": "2026-09-21T00:13:29.515Z",
"trend_7d": {
"direction": "down",
"percent": -7.98
}
}
},
{
"id": "sv3pt5-1bbbc",
"name": "151 Booster Bundle Bulk Case",
"expansion": {
"id": "sv3pt5",
"name": "151",
"total": 207,
"language": "English",
"language_code": "en",
"series": "Scarlet & Violet",
"code": "MEW",
"printed_total": 165,
"release_date": "2023/09/22",
"logo": "https://gjnrvwqtdlspyfpezgox.supabase.co/storage/v1/object/public/tcg/sets/sv3pt5.logo.png",
"symbol": "https://gjnrvwqtdlspyfpezgox.supabase.co/storage/v1/object/public/tcg/sets/sv3pt5.symbol.png"
},
"language": "English",
"language_code": "en",
"images": [
{
"type": "front",
"small": "https://api.rip.fun/storage/v1/object/public/tcg/products/sv3pt5/sv3pt5-1bbbc.png",
"medium": "https://api.rip.fun/storage/v1/object/public/tcg/products/sv3pt5/sv3pt5-1bbbc.png",
"large": "https://api.rip.fun/storage/v1/object/public/tcg/products/sv3pt5/sv3pt5-1bbbc.png"
}
],
"product_type": "bundle",
"release_date": "2023/09/22",
"tcgplayer_id": "530105",
"pricing": {
"currency": "USD",
"market": 3210.07,
"is_on_sale": false,
"updated_at": "2026-09-20T00:13:16.179Z",
"trend_7d": {
"direction": "flat",
"percent": -0.13
}
}
},
{
"id": "sv3pt5-1bbc",
"name": "151 Booster Bundle Case",
"expansion": {
"id": "sv3pt5",
"name": "151",
"total": 207,
"language": "English",
"language_code": "en",
"series": "Scarlet & Violet",
"code": "MEW",
"printed_total": 165,
"release_date": "2023/09/22",
"logo": "https://gjnrvwqtdlspyfpezgox.supabase.co/storage/v1/object/public/tcg/sets/sv3pt5.logo.png",
"symbol": "https://gjnrvwqtdlspyfpezgox.supabase.co/storage/v1/object/public/tcg/sets/sv3pt5.symbol.png"
},
"language": "English",
"language_code": "en",
"images": [
{
"type": "front",
"small": "https://api.rip.fun/storage/v1/object/public/tcg/products/sv3pt5/sv3pt5-1bbc.png",
"medium": "https://api.rip.fun/storage/v1/object/public/tcg/products/sv3pt5/sv3pt5-1bbc.png",
"large": "https://api.rip.fun/storage/v1/object/public/tcg/products/sv3pt5/sv3pt5-1bbc.png"
}
],
"product_type": "bundle",
"release_date": "2023/09/22",
"tcgplayer_id": "530105",
"pricing": {
"currency": "USD",
"market": 4211.11,
"is_on_sale": false,
"updated_at": "2026-09-20T00:13:16.179Z",
"trend_7d": {
"direction": "down",
"percent": -6.69
}
}
},
{
"id": "sv3pt5-1bbd",
"name": "151 Booster Bundle Display",
"expansion": {
"id": "sv3pt5",
"name": "151",
"total": 207,
"language": "English",
"language_code": "en",
"series": "Scarlet & Violet",
"code": "MEW",
"printed_total": 165,
"release_date": "2023/09/22",
"logo": "https://gjnrvwqtdlspyfpezgox.supabase.co/storage/v1/object/public/tcg/sets/sv3pt5.logo.png",
"symbol": "https://gjnrvwqtdlspyfpezgox.supabase.co/storage/v1/object/public/tcg/sets/sv3pt5.symbol.png"
},
"language": "English",
"language_code": "en",
"images": [
{
"type": "front",
"small": "https://api.rip.fun/storage/v1/object/public/tcg/products/sv3pt5/sv3pt5-1bbd.png",
"medium": "https://api.rip.fun/storage/v1/object/public/tcg/products/sv3pt5/sv3pt5-1bbd.png",
"large": "https://api.rip.fun/storage/v1/object/public/tcg/products/sv3pt5/sv3pt5-1bbd.png"
}
],
"product_type": "bundle",
"release_date": "2023/09/22",
"tcgplayer_id": "513405",
"pricing": {
"currency": "USD",
"market": 1876.86,
"is_on_sale": false,
"updated_at": "2026-09-21T00:13:29.515Z",
"trend_7d": {
"direction": "flat",
"percent": -0.02
}
}
},
{
"id": "sv3pt5-1bbdc",
"name": "151 Booster Bundle Display Case",
"expansion": {
"id": "sv3pt5",
"name": "151",
"total": 207,
"language": "English",
"language_code": "en",
"series": "Scarlet & Violet",
"code": "MEW",
"printed_total": 165,
"release_date": "2023/09/22",
"logo": "https://gjnrvwqtdlspyfpezgox.supabase.co/storage/v1/object/public/tcg/sets/sv3pt5.logo.png",
"symbol": "https://gjnrvwqtdlspyfpezgox.supabase.co/storage/v1/object/public/tcg/sets/sv3pt5.symbol.png"
},
"language": "English",
"language_code": "en",
"images": [
{
"type": "front",
"small": "https://api.rip.fun/storage/v1/object/public/tcg/products/sv3pt5/sv3pt5-1bbdc.png",
"medium": "https://api.rip.fun/storage/v1/object/public/tcg/products/sv3pt5/sv3pt5-1bbdc.png",
"large": "https://api.rip.fun/storage/v1/object/public/tcg/products/sv3pt5/sv3pt5-1bbdc.png"
}
],
"product_type": "bundle",
"release_date": "2023/09/22",
"tcgplayer_id": "513409",
"pricing": {
"currency": "USD",
"market": 13753.83,
"is_on_sale": false,
"updated_at": "2026-09-21T00:13:29.515Z",
"trend_7d": {
"direction": "up",
"percent": 15.06
}
}
}
],
"page": 1,
"page_size": 10,
"total_count": 3731,
"language": "en"
}curl -X GET 'https://service.rip.fun/api/v1/pokemon/sealed?page_size=10&include=prices' \ -H 'X-API-Key: rip_…'
| Field | Type | Required | Description |
|---|---|---|---|
q | string | — | Advanced search over the sealed fields: `name` (the default field, so a bare term matches the name), `id`, `product_type`, `expansion.id`, `expansion.name`, `expansion.release_date`, `language`, `price` and `is_on_sale`. Same syntax, caps and error shape as the card search — e.g. `product_type:booster_box expansion.id:sv3pt5`, `price:[100 TO *]`. Card-only fields (`rarity`, `hp`, `colors`, …) are not in scope here and return 400 with a suggestion. |
language | string | — | Language code, or a comma list. **Defaults to `en`**, exactly as the card lists do: a product inherits its expansion’s language, so an unfiltered page would interleave catalogs. Pass `language=all` for every language. The applied value comes back in the envelope. |
orderBy | string | — | Comma list; `-` prefix = DESC, e.g. `-release_date`. Max 3 keys. Sealed sorts on `name`, `price`, `release_date` and `id` — a shorter list than cards, since a product has no rarity or number to sort by. 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. |
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. |
product_type | string | — | Shorthand for `q=product_type:…`, to filter to one product family. Takes the values listed below; an unrecognised one is a 400 rather than an empty page. |
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 / name | Sealed product identity |
data[].product_type | One of `booster_pack`, `sleeved_pack`, `booster_box`, `booster_pack_case`, `bundle`, `pack_art_bundle`, `blister_pack`, `three_pack_blister_pack`, `elite_trainer_box`, `ultra_premium_collection`, `collection_box`, `special_box`, `tin`, `other`. Omitted on the few products we hold no type for. There is deliberately no `starter_deck` value: decks are stored as `other`, and nothing in the data reliably separates them from the rest of that bucket — so don’t filter for one that never arrives. |
data[].expansion | The expansion this product belongs to, serialized inline — the same object `/expansions/{id}` returns. It is complete even for the promo, tin and UPC sets the expansion endpoints don’t list, so a nested `expansion.id` can 404 on `GET /expansions/{id}` while the object beside it is fully populated. Read it from here rather than re-fetching. |
data[].language / language_code | Canonicalized language + ISO code, inherited from the expansion — a product is printed in exactly the language its set was. |
data[].release_date | `YYYY/MM/DD` — the **expansion’s** street date. A product carries no date of its own, so every product in a set reports the same day, and a later reprint still reports the original one. |
data[].msrp | Manufacturer’s list price. Present only where MSRP is what we price the product at rather than the market — today that is the Azuki catalog, which has no sales history behind it. Absent everywhere else; it is not a second opinion sitting next to `pricing.market`. |
data[].pack_count / cards_per_pack | Configuration, when known |
data[].tcgplayer_id | TCGplayer product id for cross-referencing, when we have one |
data[].images[] | Product photography, `{ type, small, medium, large }` with `type` always `front`. Same caveat as cards: `medium` is an alias of `large`. |
data[].pricing | Present only with `include=prices`: `{ currency, market, updated_at, is_on_sale, sale_price, trend_7d }`, amounts as numbers. `market` is `null` for anything priced at MSRP rather than by a market — the whole Azuki catalog today — so read `msrp` above for those and never chart the two as one series. The condition ladder and the trailing history come only from the dedicated prices endpoint below. |
| 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") |
| 400 | invalid_value | `product_type`, as the shorthand param or a `q` term, is not one of the documented values. `starter_deck` is the one people try first; it has never existed. |
See Errors for the response envelope and the full code list.