Recordings API

The Recordings API lets you access call recording URLs and download audio files for compliance archival, quality assurance, or training. Recordings are automatically generated for calls where recording is enabled in your JustCall account settings.

Get a Recording URL

Every call log entry includes a recording_url field when a recording exists. You can retrieve it through the Call Logs endpoint:

curl -X GET "https://api.justcall.io/v2/calls/call_8f3a2b1c" \
  -H "Authorization: {api_key}:{api_secret}"

Response

{
  "status": "success",
  "data": {
    "call_id": "call_8f3a2b1c",
    "direction": "inbound",
    "duration": 185,
    "recording_url": "https://recordings.justcall.io/rec_abc123.mp3",
    "recording_duration": 180,
    "status": "completed"
  }
}

If recording was not enabled or the call was too short, recording_url returns null.

Download a Recording

The recording_url is a time-limited signed URL. To download the file:

curl -L -o call_recording.mp3 "https://recordings.justcall.io/rec_abc123.mp3?token=signed_token"

Signed URLs expire after 24 hours. Request a fresh URL from the API if the link has expired.

List All Recordings

To retrieve recordings in bulk, use the Call Logs endpoint with filters and iterate through records that have a non-null recording_url:

curl -X GET "https://api.justcall.io/v2/calls?start_date=2026-03-01&end_date=2026-03-12&per_page=100" \
  -H "Authorization: {api_key}:{api_secret}"

Filter the response to extract only entries where recording_url is present.

Recording Retention Policies

JustCall retains recordings based on your plan:

After the retention period, recordings are permanently deleted. Download and archive recordings to your own storage before they expire if you need to keep them longer.

Recording File Format

Enable or Disable Recording

Recording is controlled at the account or number level in Settings → Phone Numbers → [Number] → Call Recording. The API does not toggle recording on or off — manage this setting through the dashboard.

Compliance Considerations

• Some jurisdictions require two-party consent before recording a call. Ensure your welcome message or IVR greeting notifies callers that the call may be recorded.
• Store downloaded recordings in an encrypted, access-controlled system to meet HIPAA, SOC 2, or GDPR requirements.
• Establish an internal retention and deletion schedule that aligns with your industry regulations.

Related Articles

• Call Logs API
• JustCall API Overview
• Accessing Call Recordings