Download a recording

Retrieve the audio of an accessible recorded call by its recording identifier.

Account availability: These examples describe the A1PBX version 7 interface. Confirm the endpoint, header authentication, response format, and record permissions for your assigned account before production use.

Request

Retrieve the audio of an accessible recorded call by its recording identifier.

GET/call_recordingA1PBX API

Parameters

Parameter	Type	Required	Description
`uuid`	string	Yes	Recording identifier obtained from an authorized recording result.
`type`	string	No	Explicitly request binary or base64. Availability depends on your deployed version.

Examples

Request example

1curl --fail-with-body --get \
2  "https://$A1PBX_ACCOUNT_ID.a1routes.com/app/api/7/call_recording" \
3  --header "Authorization: Basic $A1PBX_API_KEY" \
4  --data-urlencode "uuid=$RECORDING_UUID" \
5  --data-urlencode "type=binary" \
6  --output recording.audio

For type=binary, handle the response as an audio file and save it locally. For type=base64, confirm the returned encoding and envelope before decoding. Do not infer content type or a file extension from the request alone.

Integration notes

Recordings may be unavailable when recording was not enabled or the file is outside its retention period. Never expose the authenticated download URL publicly.

See authentication, pagination, and error handling.