Retrieve up to 100 cards in one request
Identifiers may mix opaque ids, natural keys and exact names. Resolved cards retain request order. Unresolved identifiers are omitted from `data` and returned in `not_found`, so do not match results by array position.
POST /cards/collection is not available from a browser. Call it from your server.
Identifiers may mix opaque ids, natural keys and exact names. Resolved cards retain request order. Unresolved identifiers are omitted from data and returned in not_found, so do not match results by array position.
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.
application/json- body
Up to 100 mixed card identifiers. Unknown properties are rejected.
identifiers*array<||>items <= 100Resolved cards and every unresolved identifier.
application/json- response
A non-paginated batch lookup. Every miss is a successful 200 entry in not_found.
object*stringdata*array<>has_more*booleannext_cursor*nullnot_found*array<||>Identifiers that did not resolve, echoed exactly as received. Match results by identifier rather than array position because unresolved identifiers are omitted from data.
curl -X POST 'https://api.rarity.dev/v1/cards/collection' \ -A 'my-app/1.0 (you@example.com)' \ -H 'Content-Type: application/json' \ -d '{ "identifiers": [ { "id": "string" } ]}'{ "object": "list", "data": [ { "object": "card", "id": "string", "oracle_id": "string", "illustration_id": "string", "external_ids": { "tcgplayer": 610429, "cardmarket": 801001 }, "lang": "string", "layout": "string", "uri": "http://example.com", "livemode": true, "updated_at": "2019-08-24T14:15:22Z", "name": "string", "text": "string", "colors": [ "string" ], "types": [ "string" ], "legalities": [ { "format": "string", "status": "string", "since": "string" } ], "faces": [ { "face_type": "string", "name": "string", "text": "string", "image": "http://example.com", "illustration_id": "string", "attributes": { "property1": null, "property2": null } } ], "printed_name": "リザードンex", "set": "string", "collector_number": "string", "rarity": "sr", "category": "string", "illustrator": "string", "products": [ "string" ], "variant": { "type": "string", "of": "string", "treatment": [ "string" ] }, "image": "http://example.com", "image_status": "missing", "prices": { "cardmarket": { "currency": "eur", "updated_at": "2019-08-24T14:15:22Z", "finishes": { "property1": { "trend": -9007199254740991, "avg": -9007199254740991, "low": -9007199254740991, "avg1": -9007199254740991, "avg7": -9007199254740991, "avg30": -9007199254740991 }, "property2": { "trend": -9007199254740991, "avg": -9007199254740991, "low": -9007199254740991, "avg1": -9007199254740991, "avg7": -9007199254740991, "avg30": -9007199254740991 } } }, "tcgplayer": { "currency": "usd", "updated_at": "2019-08-24T14:15:22Z", "finishes": { "property1": { "market": -9007199254740991, "low": -9007199254740991, "mid": -9007199254740991, "high": -9007199254740991, "direct_low": -9007199254740991 }, "property2": { "market": -9007199254740991, "low": -9007199254740991, "mid": -9007199254740991, "high": -9007199254740991, "direct_low": -9007199254740991 } } }, "pricecharting": { "currency": "usd", "updated_at": "2019-08-24T14:15:22Z", "grades": { "1": -9007199254740991, "2": -9007199254740991, "3": -9007199254740991, "4": -9007199254740991, "5": -9007199254740991, "6": -9007199254740991, "7": -9007199254740991, "8": -9007199254740991, "9": -9007199254740991, "ungraded": -9007199254740991, "9.5": -9007199254740991, "psa_10": -9007199254740991, "bgs_10": -9007199254740991, "cgc_10": -9007199254740991, "sgc_10": -9007199254740991, "cgc_10_pristine": -9007199254740991, "bgs_10_black": -9007199254740991, "tag_10": -9007199254740991, "ace_10": -9007199254740991 } } }, "source_url": "http://example.com", "game": "dragon_ball_fusion_world", "attributes": { "property1": null, "property2": null, "counter": "string", "attributes": [ "string" ], "block": "string", "trigger": "string", "upgrade_power": "string", "upgrade_hp": "string", "subtitle": "string", "unique": true, "arenas": [ "string" ], "keywords": [ "string" ], "unit_type": "string", "deploy_box": "string", "epic_action": "string", "dmg": "string", "life": "string", "hp": "string", "type": "string", "stage": "string", "attacks": [ { "cost": "string", "name": "string", "damage": "string", "text": "string" } ], "abilities": [ { "kind": "string", "name": "string", "text": "string" } ], "weakness": "string", "resistance": "string", "retreat_cost": "string", "card_type": "string", "colors": [ "string" ], "cost": "string", "specified_cost": "string", "power": "string", "combo_power": "string", "traits": [ "string" ] } } ], "has_more": false, "next_cursor": null, "not_found": [ { "id": "string" } ]}