REST API for Ethereal: Clash of Souls game data. Access myths, items, characters, and more.

All systems operational

Authentication

API Key Required

All /api/* endpoints require authentication. Include your API key in the request header.

X-API-Key: your-api-key-here

Endpoints

+ Health

1 endpoint
GET /health Server status check

M Myths (Heroes)

6 endpoints
GET /api/myths Get all myths
GET /api/myths/:id Get myth by ID
GET /api/myths/name/:name Get myth by name
GET /api/myths/class/:class Get myths by class
GET /api/myths/region/:region Get myths by region
GET /api/myths?filters Filter by difficulty, rangeType, damageType

I Items

2 endpoints
GET /api/items Get all items
GET /api/items/:id Get item by ID

C Characters

2 endpoints
GET /api/characters Get all characters
GET /api/characters/:id Get character by ID

P Players

3 endpoints
GET /api/players/:id Get player profile
GET /api/players/:id/progress Get player progress
POST /api/players/:id/progress Update player progress

G Game State

2 endpoints
GET /api/game-state Get current game state
GET /api/game-state/leaderboard Get leaderboard

U Upload

3 endpoints
POST /api/upload Upload single file
POST /api/upload/multiple Upload multiple files (max 10)
DELETE /api/upload Delete file by URL