Skip to documentation
Elemental ClashDeveloper API
ELEMENTAL CLASH · API v1

Bring the arena
into your next idea.

Explore player profiles, live matches and community progress through one consistent JSON API.

Read-onlyJSON responses100 requests / minute
GET /v1/profile?username=PlayerName
{
  "data": [{ "name": "PlayerName" }],
  "meta": { "apiVersion": "v1" }
}
A small interface to a growing world.
A GOOD PLACE TO START

Your first request

Sign in with your linked game account. At player level 5, you can create a personal API key. Admins and moderators are exempt from the level requirement.

  1. 1Create a key.It is shown once. Keep it somewhere private.
  2. 2Send it in a header.Use Authorization: Bearer or X-API-Key.
  3. 3Build with public data.Profile privacy and hidden presence still apply.

Keep API keys on your server. Never put them in a public repository, browser bundle or URL.

THE REFERENCE

Choose what you want to build with.

Base URL https://api.elementclash.io · Every endpoint below uses GET. The data field is always an array: single lookups return one item, lists return flat rows, and errors return [] with meta.code and meta.message.

HTTP

Errors & rate limits

Normal access allows 100 requests per minute per key. Your account may have a different limit. Resetting a key does not reset its rate window.

X-RateLimit-LimitYour requests-per-minute allowance.X-RateLimit-RemainingRequests left in the current window.X-RateLimit-ResetWindow reset time, as Unix seconds.Retry-AfterSeconds to wait after a 429 response.

For unsuccessful requests, check the HTTP status and meta.code/meta.message. The data array is empty; there is no separate error object.

KEY MANAGEMENT