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 an |
|
|
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 |
|---|---|
|
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 |