REST API Support - Custom Servers Are Now Welcome
We're the first OT server list to support a second monitoring protocol: REST API.
Servers running custom engines, modified protocols, or any setup where the classic TCP status port isn't available can now be fully tracked.
No other platform offers this.
How It Works
When adding your server, pick "REST API" as the protocol type instead of TCP. Point us to your status endpoint and optionally provide an auth token. The full field reference with types is available directly in the registration form.
Your endpoint must accept GET requests and return Content-Type: application/json. If you provide an authorization token, it will be sent as Authorization: Bearer <token> header.
All fields are required when is_online is true. When false, only is_online is needed.
{
"is_online": true,
"server_info": {
"name": "My Server",
"software_name": "Custom Engine",
"software_version": "1.0.0",
"client_version": 1098,
"uptime_seconds": 86400
},
"players": {
"online": 42,
"unique": 40,
"max": 500,
"peak": 120,
"list": [
{ "name": "Knight", "level": 250 },
{ "name": "Sorcerer", "level": 180 }
]
},
"world": {
"monsters_total": 4821,
"npcs_total": 312,
"map_name": "custom",
"map_author": "7x1n",
"map_width": 2048,
"map_height": 2048
},
"rates": {
"experience": 12,
"skills": 15,
"magic": 5,
"loot": 2,
"spawn": 1
},
"motd": "Welcome to the server!"
}
What You Get
Everything TCP servers get. No exceptions, no "lite" version:
- Real-time status monitoring on the same 15-60s cycle
- Player tracking - logins, logouts, level changes, session times
- Full statistics - all charts, records, historical data
- MOTD tracking and change history
- Widgets you can embed on your site
- Seasons and analytics in Creator Studio
The only thing we skip is network ping tests. Everything else is identical.
Try It
You can add a REST API server right now through the server registration form or via Creator Studio. Pick "REST API" as the protocol, enter your endpoint URL, and submit. REST API servers require manual approval before they appear publicly.