Skip to main content
The Telzino API enables you to programmatically manage AI phone agents, organizations, call logs, and more. This RESTful API uses JSON for request and response bodies and standard HTTP response codes.

​
Base URL

All API requests should be made to: 
https://api.telzino.com

​
Authentication

The Telzino API uses OAuth 2.0 with the Client Credentials grant type. To authenticate:
  1. Obtain your client_id and client_secret from the Telzino dashboard
  2. Request an access token from the /oauth/token endpoint
  3. Include the access token in the Authorization header of all subsequent requests
curl -X POST https://api.telzino.com/oauth/token \
  -H "Content-Type: application/json" \
  -d '{
    "client_id": "YOUR_CLIENT_ID",
    "client_secret": "YOUR_CLIENT_SECRET",
    "audience": "https://api.telzino.com/",
    "grant_type": "client_credentials"
  }'
The response includes an access token: 
{
  "access_token": "eyJhbGciOiJSUzI1NiIsInR5cCI6IkpXVCJ9...",
  "token_type": "Bearer",
  "expires_in": 86400
}
Use this token in the Authorization header: 
Authorization: Bearer YOUR_ACCESS_TOKEN

​
Response Codes

CodeDescription
200Success
201Created
400Bad Request - Invalid parameters
401Unauthorized - Invalid or missing token
403Forbidden - Insufficient permissions
404Not Found
500Internal Server Error

​
Pagination

List endpoints return paginated results. Use the page and limit query parameters to navigate through results: 
GET /v1/agents?page=1&limit=50
Responses include pagination metadata: 
{
  "data": [...],
  "pagination": {
    "page": 1,
    "limit": 50,
    "total": 150,
    "totalPages": 3,
    "hasNext": true,
    "hasPrev": false
  }
}

​
Rate Limits

API requests are rate limited. If you exceed the rate limit, you’ll receive a 429 Too Many Requests response. Implement exponential backoff in your integration to handle rate limits gracefully.

​
API Endpoints

Authentication

Obtain access tokens for API authentication

Agents

Create, read, update, and delete AI phone agents

Call Logs

Retrieve call transcripts and logs

Organizations

Manage organizations and resellers