Documentation

API Reference

A per-server REST API for reading your logs and server info programmatically, or managing tags from your own tools. Every request is scoped to a single server by the token you use.

Authentication

Create a token from your server's Settings → API tokens tab. Free servers can have up to 3 active tokens; each is created with either a read or read_write scope. The plaintext secret is shown once, at creation — LoggerBot only ever stores its hash, so if you lose it, revoke it and create a new one. Send it as a bearer token on every request:

curl https://loggerbot.nl/api/v1/guilds/YOUR_GUILD_ID \
  -H "Authorization: Bearer lb_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

Rate limits

500 requests per minute per token. Every response carries the usual headers so you can back off before hitting it:

X-RateLimit-Limit: 500
X-RateLimit-Remaining: 497
X-RateLimit-Reset: 1789960020

Endpoints

GET
/api/v1/guilds/:guildId

Basic server info: name, icon, member count.

read
GET
/api/v1/guilds/:guildId/logs

Search the same log history the web Log Viewer uses. Query params: search, since, until, categories, logKey, channelId, memberId, limit (max 100), offset. Retention still follows the server's plan (1 hour Free, 12 hours Pro Lite, 30 days Pro).

read
GET
/api/v1/guilds/:guildId/tags

List every tag configured on the server.

read
POST
/api/v1/guilds/:guildId/tags

Create a tag. Body: { "name": string, "content": string }.

read_write

Example: recent logs

curl "https://loggerbot.nl/api/v1/guilds/YOUR_GUILD_ID/logs?categories=members,messages&limit=20" \
  -H "Authorization: Bearer lb_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

{
  "entries": [
    { "logKey": "joinMember", "category": "members", "summary": "…", "createdAt": 1789959000000 }
  ],
  "total": 1,
  "retentionDays": 30,
  "plan": "pro"
}

Only need to read data yourself, without writing any code? The dashboard's Log Viewer and Tags pages cover the same data — the API exists for connecting LoggerBot to your own tools and dashboards.