Authentication
Authorization header.Getting Your API Key
1.
2.
3.
Making Authenticated Requests
Authorization header with every request:Request Headers
| Header | Value | Required |
|---|---|---|
Authorization | Bearer YOUR_API_KEY | Yes |
Content-Type | application/json | For POST/PATCH requests |
Example: Get Account Information
{
"id": "user-uuid-here",
"email": "you@example.com",
"company_name": "Your Company",
"minutes_balance": 500,
"monthly_usage_minutes": 120,
"active_numbers": 3,
"active_agents": 2,
"active_calls": 0
}Rate Limits
| Limit Type | Rate |
|---|---|
| General API requests | 100 requests per minute per API key |
| Call control commands | 10 commands per minute per active call |
429 Too Many Requests response.Error Responses
401 Unauthorized
{
"error": "Unauthorized",
"message": "Invalid or missing API key"
}403 Forbidden
{
"error": "Forbidden",
"message": "You don't have access to this resource"
}Security Best Practices
1.
2.
3.
4.
Modified at 2025-12-29 14:22:23