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: 1789960020Endpoints
/api/v1/guilds/:guildIdBasic server info: name, icon, member count.
/api/v1/guilds/:guildId/logsSearch 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).
/api/v1/guilds/:guildId/tagsList every tag configured on the server.
/api/v1/guilds/:guildId/tagsCreate a tag. Body: { "name": string, "content": string }.
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.