Retrieve call recordings by passing 'sessionId' using voice API v1.
API Endpoints & Postman Collection
The Voice channel is supported via Voice API v1 and Send Message API v2.
The API endpoint for it is: [https://api.{YourRegion}.webexconnect.io/v1/voice/calls/{sessionId}/recordings].
Please modify YourRegion in the URL as per your tenant’s region. See Know Your Endpoint Page.
Refer to Postman Collection for trying Get Call Recordings Using Voice API v1.
API Response and Error Codes
Voice API v1 is asynchronous. You receive an HTTP response confirming acceptance of your request immediately after invoking the API. Further processing details are sent to your callback URL. For more information, see Channel Specific Status Codes.
Request Body for Get Call Recordings API
curl --location 'https://baseURL/v1/voice/calls/{sessionId}/recordings' \
--header 'Accept: application/json' \
--header 'Authorization: ServiceKey'
Get Call Recordings Path Parameters
| Parameter | Type | Mandatory | Description |
|---|---|---|---|
| sessionId | string | yes | Unique identifier for the call. Returned in the response body of events. |
Get Call Recordings Header Parameters
| Parameter | Type | Mandatory | Description |
|---|---|---|---|
| Authorization | string | yes | Authorization token (this can be either a JWT signed by a secret key or the service key). |
Sample Response Body
{
"recordings": [
{
"durationSeconds": 4,
"url": "https://anydomain.imiconnect.co/voice-recordings/menu_1738073208_900201219666667_7.wav"
},
{
"durationSeconds": 20,
"url": "https://anydomain.imiconnect.co/voice-recordings/call_1738073208_900201219666667_4.wav"
}
],
"sessionId": "0c6f0ad0-7340-XXXX-XXXX-300ac310dee0"
}
<No Sample Body>
Response Parameters
| Parameter | Type | Description |
|---|---|---|
| recordings | JSON Array | Array of objects, each containing 'durationSeconds' and 'url' for a recording. |
| durationSeconds | integer | Duration of the recording in seconds. |
| url | string | URL to the recording file for the session. |
| sessionId | string | Unique identifier for the call associated with the recording. |