API V1

Technical Reference & Standards

The Direktor API provides industrial-grade access to competition data, allowing you to build real-time overlays, custom dashboards, and registration workflows.

Base URL

https://direktorpro.xyz/api/v1

Authentication

All API requests must include your API key in the X-Direktor-Key header. Never expose this key in client-side code.

Request Format

curl -H "X-Direktor-Key: YOUR_KEY" \

https://direktorpro.xyz/api/v1/tournaments

Endpoints

GET

List Tournaments

Retrieve a list of all active and past tournaments owned by your account.

/tournaments

[
  {
    "id": "tn_48293",
    "name": "Summer Scrabble Open",
    "status": "RUNNING",
    "current_round": 4
  }
]

GET

Tournament Details

Fetch the complete state of a tournament including divisions, players, and game history.

/tournaments/:id

{
  "id": "tn_48293",
  "name": "Summer Scrabble Open",
  "players": [...],
  "games": [...],
  "divisions": [...]
}

GET

Tournament Standings

Retrieve the current standings. Useful for driving live leaderboards and stream overlays.

/tournaments/:id/standings

{
  "players": [...],
  "games": [...]
}

GET

Round Pairings

Get the specific pairings and results for a particular round.

/tournaments/:id/pairings/:round

[
  {
    "id": "gm_102",
    "round": 4,
    "player1_id": "pl_1",
    "player2_id": "pl_5",
    "score1": 412,
    "score2": 390
  }
]

Login Required

You must be logged in as a Director to manage API keys.

Go to Auth