API Reference

Complete REST API documentation for authentication and call management

Authentication

The Kalem.me API uses Bearer token authentication. All API requests must include your API token in the Authorization header.

Base URL

https://api.kalem.me/v1

API Token

Your API token can be found in your dashboard settings. Keep your API token secure and never share it publicly.

Security Notice

Never expose your API token in client-side code or public repositories.

Authentication Example

curl -X GET "https://api.kalem.me/v1/calls" \
  -H "Authorization: Bearer your_api_token" \
  -H "Accept: application/json"

Rate Limits

API requests are rate limited to ensure fair usage:

  • • Standard Plan: 1,000 requests per hour
  • • Pro Plan: 5,000 requests per hour
  • • Enterprise: Custom limits available

Error Responses

Authentication errors return appropriate HTTP status codes:

401 Unauthorized

Missing or invalid API token

{
  "error": {
    "code": "unauthorized",
    "message": "Invalid API token"
  }
}

403 Forbidden

Valid token but insufficient permissions

{
  "error": {
    "code": "forbidden",
    "message": "Insufficient permissions for this resource"
  }
}

429 Too Many Requests

Rate limit exceeded

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded. Try again in 60 seconds."
  }
}