Skip to main content
GET
/
v1
/
creatures
List creatures.
curl --request GET \
  --url https://api.elestrals.com/v1/creatures \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": "el-159",
      "name": "Waspivy",
      "class": "spirit",
      "elements": [
        "earth"
      ],
      "blurb": "<string>",
      "constellation_number": "17",
      "element_number": "02",
      "level_number": "03",
      "images": {
        "render_thumbnail_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:name

Sort field. Prefix with - for descending.

Available options:
name,
-name,
list_order,
-list_order,
constellation_number,
-constellation_number,
updated_at,
-updated_at
​
name
string

Case-insensitive prefix match on creature name.

​
class
enum<string>[]

Multi-value class filter. Repeat or comma-separate values.

Available options:
spirit,
elestral,
rune_divine,
rune_artifact,
rune_stadium,
rune_invoke,
rune_counter
​
element
enum<string>[]

Matches if the creature has any of the listed elements.

Available options:
earth,
fire,
water,
thunder,
wind,
frost,
solar,
lunar,
omni
​
constellation_number
string

Exact-match filter on constellation_number.

​
updated_since
string<date-time>

Only return creatures updated strictly after this instant.

Response

Paginated list of creatures.

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