Introduction - Call24x7

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 Code	Description
`MISSING_PARAMS`	Required parameters are missing
`UNAUTHORIZED`	Invalid or missing API key
`INSUFFICIENT_BALANCE`	Account has insufficient balance
`AGENT_NOT_FOUND`	The specified agent ID does not exist
`CALL_NOT_FOUND`	The specified call ID does not exist
`INTERNAL_ERROR`	An 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

​Welcome to the Call24x7.AI API

​Base URL

​Authentication

​Example Request

​API Endpoints

Make Outbound Call

Get Call Status

Handle Inbound Call

​Response Format

​Success Response Example

​Error Response Example

​Error Codes

​Rate Limits

​Webhooks

OpenAPI Specification

Welcome to the Call24x7.AI API

Base URL

Authentication

Example Request

API Endpoints

Response Format

Success Response Example

Error Response Example

Error Codes

Rate Limits

Webhooks