Players API

POST /v1/identify

Set custom properties for a player. Properties are stored as JSONB and queryable in the Player Explorer.

Auth: x-game-api-key header

curl -X POST https://api.questdata.io/v1/identify \
  -H "Content-Type: application/json" \
  -H "x-game-api-key: YOUR_API_KEY" \
  -d '{
    "player_id": "player-123",
    "properties": {
      "platform": "Windows",
      "language": "en",
      "level": 15,
      "spending_tier": "dolphin"
    }
  }'

Request Body

Field	Type	Required	Description
player_id	string	Yes	Player identifier
properties	object	Yes	Key-value pairs to store

Response (200)

{
  "player_id": "player-123",
  "properties": {
    "platform": "Windows",
    "language": "en",
    "level": 15,
    "spending_tier": "dolphin"
  }
}

Properties are merged — existing properties not included in the request are preserved.

---

POST /v1/players/:player_id/tags

Add a tag to a player for segmentation.

Auth: x-game-api-key header

curl -X POST https://api.questdata.io/v1/players/player-123/tags \
  -H "Content-Type: application/json" \
  -H "x-game-api-key: YOUR_API_KEY" \
  -d '{"tag": "vip"}'

Request Body

Field	Type	Required	Description
tag	string	Yes	Tag name (auto-lowercased)

---

DELETE /v1/players/:player_id/tags/:tag

Remove a tag from a player.

Auth: x-game-api-key header

curl -X DELETE https://api.questdata.io/v1/players/player-123/tags/vip \
  -H "x-game-api-key: YOUR_API_KEY"

---

GET /v1/players/:player_id

Fetch player details including properties, tags, and session history.

Auth: x-game-api-key header or JWT Bearer

curl "https://api.questdata.io/v1/players/player-123" \
  -H "x-game-api-key: YOUR_API_KEY"

---

GET /v1/players/:player_id/timeline

Fetch a player’s event timeline.

Auth: x-game-api-key header or JWT Bearer

curl "https://api.questdata.io/v1/players/player-123/timeline?limit=50" \
  -H "x-game-api-key: YOUR_API_KEY"

Query Parameters

Parameter	Type	Default	Description
limit	number	50	Events to return
offset	number	0	Pagination offset