Base URL
https://app.larm.dev/api/v1
Authentication
All API requests require a Bearer token in the Authorization header:
curl https://app.larm.dev/api/v1/monitors \
-H "Authorization: Bearer larm_api_..."
Creating an API key
- Go to Dashboard > Settings > API Keys
- Click Create API key
- Choose permissions for each resource (monitors, status pages, alert channels)
- Copy the key — it’s only shown once
API keys use the format larm_api_<base64-payload><crc32>.
Permissions
Each API key has a permission level per resource:
| Resource | Levels |
|---|
| Monitors | none, read, read_write |
| Status pages | none, read, read_write |
| Alert channels | none, read, read_write |
Free plan API keys are read-only. Pro plan keys support both read and write access.
Rate limits
| Operation | Limit |
|---|
| Read | 120 requests/min |
| Write | 30 requests/min |
| Stats | 30 requests/min |
| Header | Description |
|---|
x-ratelimit-limit | Maximum requests allowed in the window |
x-ratelimit-remaining | Requests remaining in the current window |
x-ratelimit-reset | Unix timestamp when the window resets |
retry-after | Seconds until you can retry (only on 429) |
{
"error": {
"type": "invalid_api_key",
"message": "The provided API key is invalid or has been revoked."
}
}
Standard error codes
| Status | Type | Description |
|---|
| 401 | invalid_api_key | Missing, invalid, or revoked API key |
| 403 | insufficient_permissions | API key lacks the required permission |
| 429 | rate_limited | Too many requests — check retry-after header |
