Public API v1

WOS Control API

Access gift codes, player data, and redeem codes programmatically. Build bots, websites, and tools on top of the WOS Control platform.

Gift Codes

Player Data

Async Redeem

Transfer & State

Statistics

Authentication

Most endpoints require an API key. Pass it via one of these methods:

Authorization: Bearer wos_YOUR_KEY

X-API-Key: wos_YOUR_KEY

Redeem operations are async. Submit a request, then poll the status endpoint.

1Submit redeem request

2Get job_id in response

3Poll /api/v1/redeem/status/{job_id}

4Check status until completed

Base URL

https://woscontrol.com/api/v1

Endpoints (20)

All errors return a JSON object with an error field:

{
  "error": "Missing API key. Provide via Authorization: Bearer <key> or X-API-Key header."
}

401Missing or invalid API key

403API key banned or domain banned

404Resource not found (e.g. player)

429Rate limit exceeded

500Internal server error

502API backend unavailable

Ready to get started?