API Overview
REST API for the Kerabie customer support platform.
The Kerabie REST API lets you build custom integrations, automate workflows, and access your support data programmatically.
Base URL
https://api.kerabie.comAuthentication
All API requests require a Bearer token and your org ID:
Authorization: Bearer YOUR_API_KEY
X-Kerabie-Org: YOUR_ORG_ID
Content-Type: application/jsonGenerate an API key in Settings → API → New API Key. Keys are scoped to your organisation.
Interactive docs
Try every endpoint directly in the browser; no separate tool needed:
The playground is powered by Swagger UI and includes every endpoint with request/response schemas. Authorize with your API key once and test live requests against the real API.
Rate limits
| Plan | Requests per minute |
|---|---|
| Free | 30 |
| Starter | 120 |
| Pro | 600 |
| Business | 3,000 |
Rate limit headers are returned on every response:
X-RateLimit-Limit: 120
X-RateLimit-Remaining: 87
X-RateLimit-Reset: 1716734040Errors
All errors follow a consistent format:
{
"statusCode": 404,
"message": "Conversation not found",
"error": "Not Found"
}| Status | Meaning |
|---|---|
400 | Bad request: missing or invalid parameters |
401 | Unauthorised: missing or invalid API key |
403 | Forbidden; you don't have access to this resource |
404 | Not found |
429 | Rate limit exceeded |
500 | Server error |
Pagination
List endpoints return paginated results:
{
"data": [...],
"total": 243,
"page": 1,
"limit": 20
}Pass ?page=2&limit=50 to navigate pages.
Use with an AI assistant
Connect the Kerabie MCP server to Claude, Cursor or another MCP client and it can search these docs, read the API and TypeScript SDK types and follow the integration guide while it writes code for you. No API key is needed for that.