Skip to main content
GET
/
v1
/
printings
List physical printings.
curl --request GET \
  --url https://api.elestrals.com/v1/printings \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "cd-1000",
      "base_printing": true,
      "name": "Demeter",
      "set_number": "SD01-16",
      "sort_number": "SD01-16",
      "banlists": [
        {
          "id": "ble-1",
          "format_id": "fm-1",
          "legality": "legal",
          "effective_date": "2023-11-07T05:31:56Z",
          "lift_date": "2023-11-07T05:31:56Z"
        }
      ],
      "set": {
        "id": "st-69",
        "abbr": "SD01",
        "name": "Centaurbor Starter Deck"
      },
      "series": {
        "id": "sr-5",
        "name": "First Edition"
      },
      "rarity": "common",
      "variants": [
        {
          "name": "<string>",
          "condition": "normal",
          "images": [
            {
              "type": "card_front",
              "small": "<string>",
              "medium": "<string>",
              "large": "<string>"
            }
          ]
        }
      ],
      "canvas": "regular_art",
      "frame_material": "stone",
      "holo_pattern": "normal",
      "artist": "<string>",
      "effect_current": "<string>",
      "effect_printed": "<string>",
      "entity": {
        "id": "et-451",
        "title": "<string>",
        "title_frame": "standard",
        "class": "spirit",
        "subclasses": [
          "aquatic"
        ],
        "elements": [
          "earth"
        ],
        "cost": [
          "earth"
        ],
        "total_cost": 1,
        "attack": 1,
        "defense": 1
      },
      "images": [
        {
          "type": "card_front",
          "small": "<string>",
          "medium": "<string>",
          "large": "<string>"
        }
      ],
      "serialized": {
        "population": 1
      },
      "prize_card": true,
      "updated_at": "2023-11-07T05:31:56Z"
    }
  ],
  "pagination": {
    "next_cursor": "<string>",
    "has_more": true
  },
  "meta": {
    "request_id": "req_0123456789abcdef",
    "cached": true,
    "attribution_required": true
  }
}

Authorizations

​
Authorization
string
header
required

API key supplied as Authorization: Bearer <key>. Keys are minted in the developer portal. Rejected in query strings. See the Authentication guide.

Query Parameters

​
limit
integer
default:50

Page size, max 250.

Required range: 1 <= x <= 250
​
cursor
string

Opaque pagination cursor from a previous response's pagination.next_cursor.

​
sort
enum<string>
default:set_number

Sort field. Prefix with - for descending.

Available options:
set_number,
-set_number,
name,
-name,
release_date,
-release_date,
updated_at,
-updated_at
​
card_id
string

Filter to printings of a single card (Entity ID).

Example:

"et-100"

​
set_id
string
Example:

"st-53"

​
series_id
string
Example:

"sr-5"

​
rarity
enum<string>[]
Available options:
common,
uncommon,
rare,
stellar_rare
​
condition
enum<string>[]
Available options:
normal,
reverse_holo,
holo,
metal
​
canvas
enum<string>[]
Available options:
regular_art,
full_art,
borderless_art
​
frame_material
enum<string>[]
Available options:
stone,
tablet,
marble,
black_marble,
ethereal,
crystal
​
name
string

Case-insensitive prefix match on the printing's name.

​
artist
string

Exact-match filter on artist name (case-insensitive).

​
updated_since
string<date-time>

Response

Paginated list of printings.

​
data
object[]
required
​
pagination
object
required
​
meta
object
required