API Documentation
Integrate CALLSATHI AI into your applications.
Base URL
https://api.callsathi.com/v1All API requests require a Bearer token. Get your API key from the Dashboard → Settings.
Endpoints
POST
/api/calls/outboundInitiate an outbound AI call to a phone number.
Request
{
"phone": "+91XXXXXXXXXX",
"agentId": "agent_abc123",
"context": "Follow up on demo request",
"language": "en"
}Response
{
"callId": "call_xyz789",
"status": "initiated",
"estimatedConnect": "2s"
}POST
/api/calls/webhookWebhook endpoint for receiving call events (status updates, transcriptions, sentiment).
Request
{
"event": "call.completed",
"callId": "call_xyz789",
"duration": 240,
"transcript": "...",
"sentiment": 0.8,
"confidence": 0.98
}Response
{
"received": true
}GET
/api/dashboard/callsRetrieve call history with filtering, pagination, and analytics.
Request
Query params: ?page=1 &limit=20 &status=completed &dateFrom=2026-03-01
Response
{
"calls": [...],
"total": 156,
"page": 1,
"hasMore": true
}POST
/api/knowledge/uploadUpload documents to train your AI agent on custom knowledge.
Request
FormData: file: <PDF/DOCX/TXT> category: "product_info"
Response
{
"documentId": "doc_abc123",
"status": "processing",
"estimatedTime": "30s"
}GET
/api/dashboard/usageGet current billing period usage statistics.
Request
Headers: Authorization: Bearer <api_key>
Response
{
"minutesUsed": 1247,
"minutesTotal": 2500,
"callsToday": 34,
"avgDuration": "3m 42s"
}