POST /cards/collection

Supported formats: json

Accepts a JSON array of card identifiers,
and returns a List object
with the collection of requested cards. A maximum of
75 card references may be
submitted per request. The request must be posted
with Content-Type as application/json.

Parameter Type Atn Details
identifiers Array An array of JSON objects, each one a card identifier.
pretty Boolean Optional If true, the returned JSON will be prettified. Avoid using for production code.

Card Identifiers

Each submitted card identifier must be a JSON object with one or more
of the keys id, mtgo_id, multiverse_id, name, set, and collector_number.
The following combinations are valid identifier schemas:

Schema Format Description

id

UUID

Finds a card with the specified Scryfall id.

mtgo_id

Integer

Finds a card with the specified mtgo_id or mtgo_foil_id.

multiverse_id

Integer

Finds a card with the specified value among its multiverse_ids.

name

String

Finds the newest edition of a card with the specified name.

name,set

Strings

Finds a card matching the specified name and set.

collector_number,set

Strings

Finds a card with the specified collector_number and set.
Note that collector numbers are strings.

Multiple identifier schemas may be included in a single request.
Each identifier will return up to one card. Identifiers
that are not found will be returned in the not_found
array. While cards will be returned in the order that they were
requested, cards that aren’t found will throw off the mapping
of request identifiers to results, so you should not
rely on positional index alone while parsing the data.

Example Request

POST https://api.scryfall.com/cards/collection
{
  "identifiers": [
    {
      "id": "683a5707-cddb-494d-9b41-51b4584ded69"
    },
    {
      "name": "Ancient Tomb"
    },
    {
      "set": "mrd",
      "collector_number": "150"
    }
  ]
}