GET/api/v1/calls/{id}
Calls
Get Call
Returns call detail fields plus notes, WhatsApp summary, additional data, and a chronological transcript when available.
Request
Endpoint
GET
/api/v1/calls/{id}Authentication
x-api-keyorAuthorization: BearerPath Parameters
| Name | Type | Description |
|---|---|---|
idrequired | ObjectId | MongoDB ObjectId for the call. Invalid ids return 400. |
Response Example
response.json
{
"success": true,
"data": {
"id": "665f1a2b3c4d5e6f7a8b9c0d",
"assistant": {
"id": "66aa2b3c4d5e6f7a8b9c0d11",
"name": "Sales Bot"
},
"call_type": "phone",
"direction": "outbound",
"phone_number": "+919876543210",
"call_duration": "00:01:23",
"active": false,
"recording_url": "https://recordings.example.com/call.wav",
"additional_data": {},
"notes": null,
"whatsapp_summary": null,
"transcript": [
{
"role": "user",
"content": "Hello",
"timestamp": "2026-05-01T10:00:10.000Z"
},
{
"role": "system",
"content": "Hi, how can I help?",
"timestamp": "2026-05-01T10:00:12.000Z"
}
]
}
}Status Codes
| HTTP | Meaning | Description |
|---|---|---|
| 200 | OK | Request succeeded. |
| 400 | Bad request | Malformed input, invalid ObjectId, or no updatable fields. |
| 401 | Unauthorized | Missing, invalid, inactive, or origin-restricted API key. |
| 404 | Not found | Resource was not found inside the authenticated user's scope. |
| 429 | Rate limited | Per-IP or per-key request budget was exceeded. |
Security Model
User-scoped by default
This endpoint only sees resources owned by the user attached to the API key. If another user's id is supplied, the API responds as if the resource does not exist.