Skip to main content

Retrieve a recording URL for a Call Detail Record

GET 
/api/v1/domains/:domain_uuid/cdrs/:xml_cdr_uuid/recording-url

Returns time-limited URLs (default 10 minutes) for streaming and downloading the recording associated with the given CDR. Works uniformly across both recording-storage backends:

  • Local storage (cdrs.record_path is a filesystem path): Returns Laravel signed routes to the existing cdrs.recording.stream and cdrs.recording.download web endpoints. The signature embeds the TTL; no session cookie required by the consumer.
  • S3 / S3-compatible (cdrs.record_path === 'S3', populated by the fs:upload-call-recordings-to-s3-storage archival command): Returns presigned object URLs minted via the configured per-domain S3 disk.

Either way the consumer can GET the URL with no extra auth and receive the audio bytes (Content-Disposition: inline for audio_url, attachment for download_url).

Access rules:

  • Caller must have access to the target domain (domain scope).
  • Caller must have the xml_cdr_view permission.

Request​

Responses​

Success