Skip to main content
GET
/
v1
/
sets
List public sets.
curl --request GET \
  --url https://api.elestrals.com/v1/sets \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "st-53",
      "abbr": "BS1",
      "name": "Base",
      "type": "main",
      "series": {
        "id": "sr-3",
        "code": "KS01",
        "name": "Kickstarter"
      },
      "release_date": "2023-12-25",
      "prerelease_date": "2023-12-25",
      "card_count": 1,
      "images": {
        "banner_url": "<string>",
        "icon_url": "<string>",
        "logo_url": "<string>",
        "stamp_url": "<string>"
      },
      "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:-release_date

Sort field. Prefix with - for descending.

Available options:
release_date,
-release_date,
name,
-name,
abbr,
-abbr
series_id
string

Filter to a single series (e.g. sr-5).

type
enum<string>[]

Multi-value set type filter. Repeat the param or comma-separate values.

Available options:
main,
promo,
starter_deck,
specialty
released_before
string<date>

Only return sets released strictly before this date.

released_after
string<date>

Only return sets released strictly after this date.

Response

Paginated list of sets.

data
object[]
required
pagination
object
required
meta
object
required