Call Details API (Voice Streaming)

Fetch detailed information for a specific call using its callId.

Endpoint Description

GET https://voice-stream.alohaa.ai/v1/voice-stream/call-details

Parameters

Request Headers

Field	Value	Description	Mandatory
Content-Type	application/json	Specifies the content type of the request.	Yes
x-metro-api-key	*************************	API key for authentication purposes.	Yes

Request Parameter

Field	Data Type	Description	Mandatory
call_id	String	Unique identifier of the call	No
destination_number	String	Receiver phone number with country code	No
start_time	String	Start date in YYYY-MM-DD format	No
end_time	String	End date in YYYY-MM-DD format	No

Query Parameter Rules

• Either call_id must be provided or destination_number along with start_time and end_time must be provided

• Providing both call_id and destination_number/date range in the same request is not allowed.

Sample Request

cURL using call_id

curl --location 'https://voice-stream.alohaa.ai/v1/voice-stream/call-details?call_id=<ENTER_CALL_ID>' \
--header 'x-metro-api-key: <YOUR_API_KEY>' \
--header 'Content-Type: application/json'

cURL using destination_number

Responses

Success Response

{
  "success": true,
  "response": {
    "organisation_id": "<ORG_ID>",
    "call_type": "outgoing",
    "receiver_number": "91XXXXXXXXXX",
    "did_number": "91XXXXXXXXXX",
    "initiated_at": "2025-10-06T12:03:07.225Z",
    "call_id": "<CALL_ID>",
    "call_status": "answered",
    "call_duration": 1800,
    "call_recording_url": "<RECORDING_URL>",
    "initiator_ring_duration": 0,
    "receiver_ring_duration": 0,
    "total_ring_duration": 0
  }
}

When queried using call_id, the API returns a single call object, whereas queries using destination_number with a date range return an array of call objects.

Failure Response

{
    "success": false,
    "error": {
        "code": 1010,
        "reason": "Data not found"
    }
}