Changelog

2026-11-02Copy Anchor Link

• Breaking: the Free plan with a key goes from 5,000 requests a day to 2,000, and the day now belongs to the organization, not the key. The 60 requests a minute stay per key.
• A 429 to a request with a key carries upgrade_url in the error.
• CF-Cache-Status is readable from a browser: it joins Access-Control-Expose-Headers.
• Cross-origin GET and HEAD on /v1 are open to any site, with Access-Control-Allow-Origin: *. OPTIONS on /v1 answers 204 instead of 405 and costs no quota.
• The documentation moved from api.rarity.dev/docs, which now redirects, to rarity.dev/docs. docs_url in GET / is an absolute URL.

2026-10-30Copy Anchor Link

• GET /v1/cards/suggest ranks a whole word above the start of a word.

2026-10-29Copy Anchor Link

• One Piece and Fusion World images move to images.rarity.dev.

2026-10-27Copy Anchor Link

• Breaking: game on GET /v1/cards/suggest is repeatable, so a client generated from the document types it as a list. Up to 10 values of up to 64 characters.
• Dragon Ball Super Fusion World joins the catalog, in English and Japanese, with Cardmarket prices on English prints.

2026-10-26Copy Anchor Link

• prices.pricecharting adds graded prices to Pokémon prints.
• One Piece and Star Wars Unlimited prints get prices.tcgplayer.

2026-10-25Copy Anchor Link

• Breaking: prices is one object per source, each with currency, updated_at and finishes. Amounts are integers in minor units. prices.eur and prices.eur_foil are gone.
• Breaking: the game policy in GET /v1/games/{game} no longer has attribution.
• external_ids on every print carries the TCGplayer and Cardmarket product ids.

2026-10-23Copy Anchor Link

• New GET /v1/cards/suggest.

2026-10-22Copy Anchor Link

• Breaking: X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset are optional on every response except the 429.
• Breaking: rarity is nullable. null means the source gives no rarity, and none means the card prints no rarity symbol.
• Pokémon prints get Cardmarket prices and products.

2026-10-19Copy Anchor Link

• Breaking: status, revealed_at and data_completeness leave the card.
• Breaking: the card.revealed webhook is now card.created, with the same meaning. POST /v1/webhooks refuses the old name with unknown_event_type.
• Pokémon joins the catalog, in English and Japanese.
• Sets are a resource: new GET /v1/sets, with the release date.

2026-08-27Copy Anchor Link

• New GET /v1/catalogs/price_sources.

2026-08-22Copy Anchor Link

• The published rate limits are enforced on /v1.

2026-08-21Copy Anchor Link

• Naruto joins the catalog.

2026-08-20Copy Anchor Link

• New webhook subscription endpoints.

2026-08-17Copy Anchor Link

• API keys: send Authorization: Bearer rar_live_....

2026-08-13Copy Anchor Link

• A parameter that takes one value answers 400 repeated_parameter when it is repeated.

2026-08-10Copy Anchor Link

• New bulk exports: GET /v1/bulk.

2026-08-08Copy Anchor Link

• New q= query language, order=, POST /v1/cards/collection, GET /v1/changes, GET /v1/migrations and GET /v1/games/{game}.

2026-08-07Copy Anchor Link

• First release of /v1, with One Piece and Star Wars Unlimited.