v1
latestOpenAPI 3.0.12026-07-2691137122.3 KBCallingService
Get Phone Call History
Returns all calls where a phone number appears as caller or callee, with cost and credit details and optional transcripts.
get/api/v1/calling/phone-history
Query parameters
phonestring required
Phone number in E.164 format. Example: +1234567890.
pageinteger
Page number. Defaults to 1.
page_sizeinteger
Results per page. Defaults to 20. Maximum 100.
include_transcriptsboolean
Set to true to include transcripts in each call result.
Response
call history retrieved successfully
Example response
{
"success": true,
"message": "call history retrieved successfully",
"phone": "+919876543210",
"total_count": 3,
"page": 1,
"page_size": 20,
"calls": [
{
"duration_sec": 250,
"cost_total": "12.50",
"twilio_cost": 5.1,
"model_cost": 4.2,
"credit_breakdown": {
"model_credits": 4.2,
"provider_credits": 5.1,
"telephony_base_credits": 4
},
"call_latency_ms": 820,
"transcripts": [
{
"message": {
"role": "agent",
"content": "Hello!"
},
"timestamp_ms": 1765437000123
}
]
}
]
}