API Reference Overview
Interact programmatically with the KantaSwara platform using our REST API.
Base URL
All API requests should be made to the following base URL:
Authentication
The KantaSwara API uses Bearer tokens for authentication. You must include your API key in the Authorization header of every request.
You can generate and revoke API keys from your Organization Dashboard under Settings > API Keys. Keep your keys secure and never expose them in client-side code.
Rate Limits
To ensure platform stability, the API is rate-limited. The default limit is 100 requests per minute per organization. If you exceed this limit, the API will return a 429 Too Many Requests status code.
Standard Error Responses
The API uses standard HTTP status codes to indicate the success or failure of a request. Error responses include a JSON body with a specific error code and a human-readable message.
| Status Code | Description |
|---|---|
| 200 / 201 | Success |
| 400 | Bad Request - Invalid parameters or missing required fields. |
| 401 | Unauthorized - Invalid or missing API key. |
| 403 | Forbidden - You lack permission to access this resource. |
| 404 | Not Found - The requested resource does not exist. |
| 429 | Too Many Requests - Rate limit exceeded. |
| 500 | Internal Server Error - Something went wrong on our end. |