Skip to main content
Dialflo APIs allow you to programmatically initiate AI-powered voice calls and retrieve structured insights after a call is completed. With these APIs, you can:
  • Initiate outbound calls with personalized context
  • Retrieve post-call conversation insights
  • Receive call data in real time via webhooks

​
Base URL

All API requests are made to: 
https://api.dialflo.ai

​
Authentication

All API requests require authentication using your organization’s API token. Include the following headers with every request: 
{
  "auth_token": "Bearer <YOUR_DIALFLO_API_TOKEN>",
  "Content-Type": "application/json"
}

​
Available Endpoints

​
Get Call Details

GET /call_details/<TASK_ID> Retrieves structured insights and metadata for a completed call.

​
Request

curl --location 'https://api.dialflo.ai/call_details/<task_id>' \
--header 'auth_token: Bearer <YOUR_DIALFLO_API_TOKEN>'

​
Response

The response includes comprehensive call data and AI-generated insights: 
[
    {
        "agent_name": "ONEST",
        "call_context": {},
        "call_insights": {
            "metadata": {
                "degree": "No",
                "call_time": "20th March 10 AM",
                "current_job": "",
                "current_city": ""
            },
            "user_interest": {
                "status": "Unclear",
                "confidence_score": 0.0,
                "reasoning": "The user did not provide a clear response to any of the questions."
            },
            "next_action": {
                "value": "REDIAL",
                "reason": "Candidate did not engage in the discussion."
            }
        },
        "call_recording_url": "https://media.plivo.com/v1/Account/MAZTM5OTQ0YZG5YJAYNT/Recording/ffd20998-3f37-4ddb-9341-0a1c9061b36c.mp3",
        "from_number": "918035736461",
        "to_number": "917407656243",
        "call_status": "ANSWERED",
        "call_duration": 23.0
    }
]

​
Response Fields

FieldTypeDescription
agent_namestringName of the AI agent that made the call
call_contextobjectCustom context variables passed during call initiation
call_insightsobjectAI-generated insights from the conversation
call_insights.metadataobjectExtracted data points from the conversation
call_insights.user_interestobjectUser’s interest level with confidence score and reasoning
call_insights.next_actionobjectRecommended next action with explanation
call_recording_urlstringURL to access the call recording
from_numberstringPhone number the call was made from
to_numberstringPhone number the call was made to
call_statusstringStatus of the call (e.g., ANSWERED, NO_ANSWER, BUSY)
call_durationnumberDuration of the call in seconds

​
Rate Limits

Rate limits apply to all API endpoints. Contact your account manager for details specific to your plan.

​
Support

For API support or questions, contact: abhishek@dialflo.ai