Retrieve a game
Returns the game's policy, formats and `attributes` JSON Schema. Generic clients can read `attributes_schema` to build game-specific filters without hardcoding publisher fields.
Returns the game's policy, formats and attributes JSON Schema. Generic clients can read attributes_schema to build game-specific filters without hardcoding publisher fields.
ApiKeyAuthorizationBearer <rar_live_*>Send Authorization: Bearer rar_live_..., or use rar_test_... for a test key. Both lanes currently read the same catalogue. Without a key you stay in the anonymous lane: 30 requests/minute and 1,000/day, against 60/minute per key and 2,000/day per organization with one on the Free plan. Sending a key that is malformed, revoked or unknown is a 401; sending none is not.
game*stringGame code, as returned in a card's game.
^[^\u0000-\u001f\u007f-\u009f]*[^\u0000-\u001f\u007f-\u009f\s][^\u0000-\u001f\u007f-\u009f]*$If-None-Match?stringETag already known to the client. A 304 does not consume rate limit.
The game.
application/json- response
A registered game: its policy, its formats, and the schema of its attributes.
object*stringcode*GameCodeGame code. The list grows: treat it as an open string. Adding a value is not a breaking change.
policy*formats*array<>attributes_schema*JSON Schema 2020-12 for this game's attributes object, returned as data. Generic clients can read it to build game-specific filters. Adding a game changes this schema without changing the shared card fields.
search_uri*stringEvery card of this game. Relations in this API are search URLs, never sub-collections.
uricurl -X GET 'https://api.rarity.dev/v1/games/one_piece' \ -A 'my-app/1.0 (you@example.com)'{ "object": "game", "code": "one_piece", "policy": { "monetizable": true, "images": "hosted", "since": "string", "notes": [ "string" ] }, "formats": [ { "format": "standard", "blocks": [ "string" ], "rotated": [ "string" ], "since": "string" } ], "attributes_schema": {}, "search_uri": "http://example.com"}Suggest prints for free text GET
Autocomplete over prints: the prints that best match what the user typed, best first. It tolerates a misspelled name, reads `printed_name`, and understands the collector number as the card prints it. Words can be combined, as in `pikachu 58/102` or `charizard base`: a print that more words match ranks higher. Prints with the same score are ordered by `id`, so the same request always returns the same body. With several games, prints that match more words in full come first, from any game. Among prints that match as many words in full, the games take turns: the best print of each game, then the second of each game, and so on. A full match in one game therefore ranks above a misspelling in another. The response is the list envelope of `GET /v1/cards` with whole cards, and never has a next page: `has_more` is always false. Use `GET /v1/cards` to page through a catalogue. An unknown query parameter returns 400 (`unknown_parameter`).
List price sources GET
Returns the market, currency, freshness, attribution, commercial-use policy, terms and games covered by every configured price source.