API Reference

REST API Docs

Base URL: https://api.yourapp.com/v1

Authentication

Read endpoints are public. Write endpoints require your API key in the X-API-Key header. The key is shown once at board creation.

X-API-Key: lb_yourapikey32charshere0000000000

POST/leaderboardsPublic▼

GET/leaderboards/:idPublic▼

POST/leaderboards/:id/entries🔑 Auth▼

PATCH/leaderboards/:id/entries/:entry_id/increment🔑 Auth▼

POST/leaderboards/:id/reset🔑 Auth▼

DELETE/leaderboards/:id/entries/:entry_id🔑 Auth▼

Rate Limits

Public read endpoints300 req/min per IP

Authenticated writes600 req/min per API key

Max delta per call±10,000

Max entries per board10,000

Over limit responseHTTP 429 + Retry-After header