Developers

API Reference

A read-focused REST API for building integrations. The planned base URL is https://api.lnrs.dev. Protected routes authenticate with a Bearer token, rate-limited to 120/min.

Not available yet

None of the endpoints below are live, and keys are not being issued yet. This page documents the planned shape so you can design against it. Join the waitlist and we’ll message you when it ships.

Authentication

Authorization header

curl https://api.lnrs.dev/v1/stats \
  -H "Authorization: Bearer lnrs_sk_live_..."

GET/v1/health PlannedPublic

Health

Public health probe. No authentication required, use it for status checks and uptime monitoring.

Request

curl https://api.lnrs.dev/v1/health \
  -H "Accept: application/json"

200 · Response

{
  "status": "operational",
  "uptime": 1209600,
  "shards": 1,
  "version": "3.0.0"
}

GET/v1/stats Planned Bearer

Global statistics

Aggregate counts across every shard.

Request

curl https://api.lnrs.dev/v1/stats \
  -H "Authorization: Bearer lnrs_sk_live_..."

200 · Response

{
  "guilds": 4021,
  "users": 812043,
  "channels": 58210,
  "commandsRun": 9847123
}

GET/v1/guilds/{id} Planned Bearer

Guild overview

Configuration summary and recent activity for a guild you manage.

Parameters

idsnowflakeREQUIREDThe Discord guild ID.

Request

curl https://api.lnrs.dev/v1/guilds/927174149873795122 \
  -H "Authorization: Bearer lnrs_sk_live_..."

200 · Response

{
  "id": "927174149873795122",
  "name": "Lunaris HQ",
  "memberCount": 2681,
  "modules": { "leveling": true, "tickets": true },
  "prefix": "l?"
}

GET/v1/guilds/{id}/leaderboard Planned Bearer

XP leaderboard

Top members ranked by XP.

Parameters

idsnowflakeREQUIREDThe Discord guild ID.

limitintegerRows to return (1–100, default 10).

Request

curl https://api.lnrs.dev/v1/guilds/927174149873795122/leaderboard \
  -H "Authorization: Bearer lnrs_sk_live_..."

200 · Response

{
  "leaderboard": [
    { "userId": "712989...", "level": 42, "xp": 176400, "rank": 1 },
    { "userId": "548102...", "level": 39, "xp": 152100, "rank": 2 }
  ]
}

GET/v1/guilds/{id}/cases Planned Bearer

Moderation cases

Recent moderation cases for a guild.

Parameters

idsnowflakeREQUIREDThe Discord guild ID.

Request

curl https://api.lnrs.dev/v1/guilds/927174149873795122/cases \
  -H "Authorization: Bearer lnrs_sk_live_..."

200 · Response

{
  "cases": [
    { "caseId": 184, "type": "ban", "userId": "...", "moderatorId": "...", "reason": "raiding" }
  ]
}

Join the API waitlist

Sign in with Discord to join the waitlist. Keys aren’t being issued yet, we’ll DM you once the API is live. Every request is reviewed by hand, and keys will be read-scoped by default.