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 |
---|---|---|
|
✓ |
Return data as a JSON blob |
|
Return data as a CSV table |
|
|
Return a formatted plaintext snippet |
|
|
Return an |
|
|
Return an |
Image and File Requests
The image
and file
formats will return an HTTP 302
redirect
directly to an image file or another downloadable item.
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 422 error.
Multiple card types contain two images, which can all be browsed here.
Text and Image Headers
When you request the text
or image
format, the API will also set
two additional HTTP headers:
Header | Description |
---|---|
|
A URI the Scryfall permapage for the returned card. |
|
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 |
---|---|
|
Will have the value |
|
A URI to the next CSV page.
You can submit an HTTP |