Deleted calls provide an audit trail of call records that have been removed from the platform. Each record retains key information from the original CDR (phone numbers, timing, duration, and wholesale costs) along with a reference to the user activity log entry that recorded the deletion.
Deleted call records are not kept permanently. After a retention period, they are fully removed from the platform and made available through disaster recovery files.
Access to deleted calls requires data protection permissions.
For active call records, see Calls.
Methods
GET
Retrieve Single Deleted Call
/backend/api/v1/deletedCalls/ID - fetch deleted call with specified ID.
List Deleted Calls
/backend/api/v1/deletedCalls/ - list all deleted calls.
/backend/api/v1/CDRFiles/ID/deletedCalls/ - list deleted calls from the CDR file with specified ID.
Additional Query Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
minDate |
date | No | Only return deleted calls from this date onwards (YYYY-MM-DD) |
maxDate |
date | No | Only return deleted calls up to this date (YYYY-MM-DD) |
Standard pagination parameters (limit, offset, idAfter, createdSince, updatedSince) are also supported.
Example Request
Fetch deleted calls from a specific CDR file:
curl -H "Authorization: Bearer YOUR_API_TOKEN" \
"https://YOUR_DOMAIN/backend/api/v1/CDRFiles/294/deletedCalls/"
Fields
| Field | Name | Type | Description |
|---|---|---|---|
| target | Billed Number (CDR) | Text | The phone number that was billed for this deleted call as reported in the CDR |
| extension | Extension | Text | The extension number used for this deleted call, if applicable |
| external | Third Party Number | Text | The third-party number that was called or that called the billed number |
| terminationNumber | Termination Number | Text | The number where this deleted call terminated |
| locationCarrier | Carrier Location | Text | The location information provided by the carrier for this deleted call |
| callTypeDirectionFlag | Call Leg | Preset Value | Indicates whether this was an inbound or outbound call (A-leg, B-leg) |
| chargeBand | Carrier Charge Band | Text | The charge band used by the carrier to bill this deleted call |
| callTypeOriginationTypeFlag | Call Origination Type | Preset Value | Indicates the type of origination for this deleted call if applicable (e.g., mobile, landline, payphone) |
| callTypeRecordingFlag | Call Recording | Preset Value | Indicates whether this deleted call was recorded |
| startDate | Call Date | Date | The date when the deleted call occurred |
| startTime | Call Time | Text | The time when the deleted call started |
| tariffTime | Rating Period | Preset Value | The time period rating applied to this deleted call (e.g., daytime, evening, weekend) |
| duration | Duration (s) | Number | The duration of the deleted call in seconds |
| answerTime | Answer Time (s) | Number | The time in seconds between call setup and answer |
| costCDR | Wholesale Cost (p) | Text | The wholesale cost of this deleted call in pence as reported by the carrier |
| costSuggestedRetail | Suggested Retail Cost (p) | Text | The suggested retail cost for this deleted call in pence |
| costCDRBasic | Basic Wholesale Cost (p) | Text | The basic wholesale cost of this deleted call in pence, excluding any surcharges |
| costCDRAccessCharge | Wholesale Access Charge (p) | Text | The wholesale access charge component of this deleted call in pence |
| costCDRSurchargeMobileOrigination | Wholesale Mobile Origination Surcharge (p) | Text | The wholesale mobile origination surcharge component of this deleted call in pence |
| costCDRSurchargePayphoneOrigination | Wholesale Payphone Origination Surcharge (p) | Text | The wholesale payphone origination surcharge component of this deleted call in pence |
| costCDRSurchargeCallRecording | Wholesale Cost Call Recording Surcharge (p) | Text | The wholesale call recording surcharge component of this deleted call in pence |
| carrier | Carrier | Preset Value | The carrier responsible for this deleted call |
| callCarrier | Call Carrier | Preset Value | The carrier that handled this specific deleted call (may differ from the primary carrier) |
| CDRFileID | CDR File | Text | The ID of the CDR file that contained this deleted call record |
| lineNumber | Line Number | Text | The line number in the CDR file where this deleted call record appeared |
| carrierCallID | Carrier Call ID | Text | The call identifier provided by the carrier |
| userActivityLog | Deleted in User Activity ID | Text | The ID of the user activity log entry that recorded the deletion of this call |
| id | Deleted Call ID | Text | The unique identifier for this deleted call record |