Get Call Status

GET /v1/calls/{callId}

Retrieve a call belonging to the customer associated with your API key.

Parameters and headers

Name	Location	Required	Description
callId	path	Yes	The complete ID returned by POST /otp-call.
X-API-Key	header	Yes	Your customer API key.

curl 'https://api.kokilcloud.com/v1/calls/YOUR_CALL_ID' \
  -H 'X-API-Key: YOUR_API_KEY'

Response

HTTP 200 OK — illustrative completed call:

{
  "callId": "YOUR_CALL_ID",
  "phone": "+8801712345678",
  "status": "completed",
  "outcome": "completed",
  "answeredAt": "2026-10-31T06:00:00.000Z",
  "endedAt": "2026-10-31T06:00:12.000Z",
  "talkDurationSec": 12,
  "costPoisha": 55
}

The duration and cost above are examples, not a quoted rate.

Field	Type	Description
callId	string	Call request ID.
phone	string	Normalized E.164 destination.
status	string	Overall request state. See Call Lifecycle.
outcome	string or null	Latest attempt’s outcome; null when unavailable.
answeredAt	string or null	Answer timestamp in ISO 8601 UTC, when available.
endedAt	string or null	End timestamp in ISO 8601 UTC, when available.
talkDurationSec	number or null	Latest attempt’s talk duration in seconds.
costPoisha	integer	Call charge in poisha. Divide by 100 for Bangladeshi taka.

Polling

Poll at a modest interval, such as 3–5 seconds, and stop after a final status. Apply a timeout in your application rather than polling forever. This API does not currently offer customer webhook callbacks.

Errors

An unknown call ID, or a call that belongs to another customer, returns 404 Call not found. An invalid API key returns 401; an inactive account returns 403.