Skip to main content

​
Welcome to the Call24x7.AI API

The Call24x7.AI API enables you to make AI-powered phone calls programmatically. Use our REST API to initiate outbound calls, handle inbound calls, and manage your AI agents.

​
Base URL

All API requests should be made to: 
https://api.call24x7.ai

​
Authentication

All API endpoints require authentication using an API key. Include your API key in the Authorization header as a Bearer token: 
Authorization: Bearer YOUR_API_KEY
Get your API key from the Call24x7.AI Developer Portal.

​
Example Request

curl -X POST https://api.call24x7.ai/outbound_call \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "to_phone_number": "+1234567890",
    "agent_id": "your-agent-id"
  }'

​
API Endpoints

The Call24x7.AI API provides the following main endpoints:

Make Outbound Call

Initiate an outbound phone call using an AI agent (POST)

Get Call Status

Retrieve the status of an existing call (GET)

Handle Inbound Call

Process incoming calls from Twilio (POST)

​
Response Format

All API responses are returned in JSON format. Successful responses include a success: true field, while errors include success: false along with an error message and error code.

​
Success Response Example

{
  "success": true,
  "call_id": "12345",
  "status": "RINGING",
  "message": "Call initiated successfully"
}

​
Error Response Example

{
  "success": false,
  "message": "Missing required parameter: to_phone_number",
  "error_code": "MISSING_PARAMS"
}

​
Error Codes

The API uses the following error codes:
Error CodeDescription
MISSING_PARAMSRequired parameters are missing
UNAUTHORIZEDInvalid or missing API key
INSUFFICIENT_BALANCEAccount has insufficient balance
AGENT_NOT_FOUNDThe specified agent ID does not exist
CALL_NOT_FOUNDThe specified call ID does not exist
INTERNAL_ERRORAn internal server error occurred

​
Rate Limits

API requests are subject to rate limiting. If you exceed the rate limit, you’ll receive a 429 Too Many Requests response.

​
Webhooks

You can configure webhooks to receive notifications when calls complete. Include a webhook_url parameter in your call requests to receive call completion events.

OpenAPI Specification

View the complete OpenAPI specification