Call Detail Records API — CDR Ingestion and Retrieval

Call detail records (CDRs) capture a complete log of every call that passes through the platform. Each record stores the originating caller_number, the destination_number, call direction (inbound or outbound), the final disposition (e.g. ANSWERED or NO ANSWER), raw and billable duration in seconds, the computed cost, and precise start and end timestamps. CDRs are associated with a tenant and optionally with the extension that handled the call. All endpoints require an active admin session. The list endpoint supports search across caller_number, destination_number, direction, and disposition, and orders results by started_at descending.

GET /api/cdrs

Returns all CDRs ordered by started_at descending, with the tenant and extension relations included. Query parameters

string

Optional. Filters CDRs whose caller_number, destination_number, direction, or disposition contains the given string (case-insensitive).

string

Value is "CDRs fetched successfully.".

array

Array of CDR objects.

Show CDR object fields

integer

Auto-incremented primary key.

integer

ID of the tenant this CDR belongs to.

integer|null

ID of the extension that handled the call, if applicable.

string

The originating phone number, e.g. "+12125550001".

string

The dialled destination number, e.g. "+13125551001".

string

Call direction: inbound or outbound.

string

Final call result, e.g. ANSWERED, NO ANSWER, or BUSY.

integer

Total call duration from answer to hangup in seconds.

integer

Billable duration in seconds, after applying the rate’s billing_increment rounding.

string

Calculated call cost as a decimal with up to four decimal places, e.g. "0.0240".

string

ISO 8601 timestamp when the call was initiated.

string|null

ISO 8601 timestamp when the call ended. null if the call is still active or was not recorded.

object

The parent tenant object.

object|null

The extension object that handled the call, or null if no extension was involved.

string

ISO 8601 creation timestamp for the CDR record.

string

ISO 8601 last-updated timestamp.

curl https://your-instance.laracopilot.com/api/cdrs \
  -H "Accept: application/json" \
  -b cookies.txt

curl "https://your-instance.laracopilot.com/api/cdrs?search=ANSWERED" \
  -H "Accept: application/json" \
  -b cookies.txt

{
  "message": "CDRs fetched successfully.",
  "data": [
    {
      "id": 1,
      "tenant_id": 1,
      "extension_id": 2,
      "caller_number": "+12125550001",
      "destination_number": "+13125551001",
      "direction": "inbound",
      "disposition": "ANSWERED",
      "duration_seconds": 185,
      "bill_seconds": 180,
      "cost": "0.0600",
      "started_at": "2025-04-22T10:00:00.000000Z",
      "ended_at": "2025-04-22T10:03:05.000000Z",
      "tenant": { "id": 1, "name": "Acme Corp" },
      "extension": { "id": 2, "extension_number": "1002", "display_name": "Bob Jones" },
      "created_at": "2025-04-22T10:03:05.000000Z",
      "updated_at": "2025-04-22T10:03:05.000000Z"
    }
  ]
}

POST /api/cdrs

Creates a new CDR record manually and returns 201 Created. This endpoint is typically used to ingest CDRs from an external telephony platform.

integer

required

ID of the tenant this CDR belongs to. Must reference an existing tenant.

integer

Optional. ID of the extension that handled the call. Must reference an existing extension when provided.

string

required

Originating phone number. Maximum 50 characters.

string

required

Dialled destination number. Maximum 50 characters.

string

required

Call direction, e.g. inbound or outbound. Maximum 50 characters.

string

required

Final call result, e.g. ANSWERED, NO ANSWER, BUSY. Maximum 50 characters.

integer

required

Total call duration in seconds. Minimum value: 0.

integer

required

Billable call duration in seconds. Minimum value: 0.

number

required

Calculated call cost as a decimal. Minimum value: 0.

string

required

Call start timestamp. Must be a valid date string parseable by PHP’s date rules, e.g. "2025-04-22 10:00:00".

string

Optional. Call end timestamp. Must be a valid date string when provided.

string

Value is "CDR created successfully.".

object

The newly created CDR record.

curl -X POST https://your-instance.laracopilot.com/api/cdrs \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -b cookies.txt \
  -d '{
    "tenant_id": 1,
    "extension_id": 2,
    "caller_number": "+12125550099",
    "destination_number": "+14155550010",
    "direction": "outbound",
    "disposition": "ANSWERED",
    "duration_seconds": 240,
    "bill_seconds": 240,
    "cost": 0.0960,
    "started_at": "2025-04-22 14:00:00",
    "ended_at": "2025-04-22 14:04:00"
  }'

{
  "message": "CDR created successfully.",
  "data": {
    "id": 2,
    "tenant_id": 1,
    "extension_id": 2,
    "caller_number": "+12125550099",
    "destination_number": "+14155550010",
    "direction": "outbound",
    "disposition": "ANSWERED",
    "duration_seconds": 240,
    "bill_seconds": 240,
    "cost": "0.0960",
    "started_at": "2025-04-22T14:00:00.000000Z",
    "ended_at": "2025-04-22T14:04:00.000000Z",
    "created_at": "2025-04-22T14:04:01.000000Z",
    "updated_at": "2025-04-22T14:04:01.000000Z"
  }
}

GET /api/cdrs/

Fetches a single CDR by its ID. Includes the tenant and extension relations. Path parameters

integer

required

The numeric ID of the CDR to retrieve.

string

Value is "CDR loaded successfully.".

object

The CDR record with tenant and extension included.

curl https://your-instance.laracopilot.com/api/cdrs/2 \
  -H "Accept: application/json" \
  -b cookies.txt

{
  "message": "CDR loaded successfully.",
  "data": {
    "id": 2,
    "tenant_id": 1,
    "extension_id": 2,
    "caller_number": "+12125550099",
    "destination_number": "+14155550010",
    "direction": "outbound",
    "disposition": "ANSWERED",
    "duration_seconds": 240,
    "bill_seconds": 240,
    "cost": "0.0960",
    "started_at": "2025-04-22T14:00:00.000000Z",
    "ended_at": "2025-04-22T14:04:00.000000Z",
    "tenant": { "id": 1, "name": "Acme Corp" },
    "extension": { "id": 2, "extension_number": "1002", "display_name": "Bob Jones" },
    "created_at": "2025-04-22T14:04:01.000000Z",
    "updated_at": "2025-04-22T14:04:01.000000Z"
  }
}

PUT /api/cdrs/

Replaces all fields on an existing CDR. PATCH /api/cdrs/{cdr} is also accepted and uses the same handler. Path parameters

integer

required

The numeric ID of the CDR to update.

integer

required

Must reference an existing tenant.

integer

Optional. Must reference an existing extension when provided.

string

required

Maximum 50 characters.

string

required

Maximum 50 characters.

string

required

Maximum 50 characters.

string

required

Maximum 50 characters.

integer

required

Minimum value: 0.

integer

required

Minimum value: 0.

number

required

Minimum value: 0.

string

required

Valid date string.

string

Optional. Valid date string.

string

Value is "CDR updated successfully.".

object

The updated CDR record.

curl -X PUT https://your-instance.laracopilot.com/api/cdrs/2 \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -b cookies.txt \
  -d '{
    "tenant_id": 1,
    "extension_id": 2,
    "caller_number": "+12125550099",
    "destination_number": "+14155550010",
    "direction": "outbound",
    "disposition": "ANSWERED",
    "duration_seconds": 240,
    "bill_seconds": 240,
    "cost": 0.0960,
    "started_at": "2025-04-22 14:00:00",
    "ended_at": "2025-04-22 14:04:00"
  }'

{
  "message": "CDR updated successfully.",
  "data": {
    "id": 2,
    "tenant_id": 1,
    "extension_id": 2,
    "caller_number": "+12125550099",
    "destination_number": "+14155550010",
    "direction": "outbound",
    "disposition": "ANSWERED",
    "duration_seconds": 240,
    "bill_seconds": 240,
    "cost": "0.0960",
    "started_at": "2025-04-22T14:00:00.000000Z",
    "ended_at": "2025-04-22T14:04:00.000000Z",
    "created_at": "2025-04-22T14:04:01.000000Z",
    "updated_at": "2025-04-22T14:10:00.000000Z"
  }
}

DELETE /api/cdrs/

Permanently deletes the specified CDR record. Path parameters

integer

required

The numeric ID of the CDR to delete.

string

Value is "CDR deleted successfully.".

curl -X DELETE https://your-instance.laracopilot.com/api/cdrs/2 \
  -H "Accept: application/json" \
  -b cookies.txt

{
  "message": "CDR deleted successfully."
}

Authentication

Resources

Messaging

Call Detail Records API — CDR Ingestion and Retrieval

GET /api/cdrs

POST /api/cdrs

GET /api/cdrs/

PUT /api/cdrs/

DELETE /api/cdrs/

​GET /api/cdrs

​POST /api/cdrs

​GET /api/cdrs/

​PUT /api/cdrs/

​DELETE /api/cdrs/

GET /api/cdrs

POST /api/cdrs

GET /api/cdrs/

PUT /api/cdrs/

DELETE /api/cdrs/