Request Formats

Each Scryfall API method will return data as a JSON blob. Some methods support additional alternative formats. Each API method documents which formats it will support.

Format Default Desc

json

Return data as a JSON blob

csv

Return data as a CSV table

image

Return an HTTP 302 redirect to an image file

text

Return a formatted plaintext snippet

Image Requests

The image format will return an HTTP 302 redirect to an image file URI. Ensure your HTTP library will accept this behavior if you use it.

Image Requests: Version

When requesting the image format, you may also provide a version parameter for the specific image version you would like returned. It can be small, normal, large, png, art_crop, or border_crop. The default is large.

Image Requests: Back Face

When requesting the image format, you may also provide a face parameter with the value back. If this card has two faces, a redirect to an image for the back face of the card will be returned. If this card does not have a back face, the method will return a 404 error.

Currently the only cards with two images are those with a layout property with the values transform or double_faced_token.

Text and Image Headers

When you request the text or image format, the API will also set two additional HTTP headers:

Header Description

X-Scryfall-Card

A URI the Scryfall permapage for the returned card.

X-Scryfall-Card-Image

A URI to an image of the card returned

CSV Format Headers

When you request the csv format, the API will set these additional additional HTTP headers:

Header Description

X-Scryfall-Has-More

Will have the value true if there is another page of CSV data beyond this one

X-Scryfall-Next-Page

A URI to the next CSV page. You can submit an HTTP GET request to this URI to continue paginating.