Retrieve calls handled by the Cloud PBX, newest first.

When to use. Historical and audit views of call activity. For the detailed call records behind the Call Analytics report, use GET /cdrs.

Filtering and shape. Filter, order, limit and select fields by any response field. See Core API Concepts. Common filters are caller_user_id, start_at and end_at (ISO-8601 UTC), status, dst and dst_country. The response is wrapped as { "calls": [ ... ], "total_calls": N }.

Example. GET /api/calls/start_at/2020-09-01T00:00:00/limit/50;0

Gateway note: custom call fields defined on the account can be used as filter keys (path segments, see the _filtered variant) and are returned on each record alongside the standard fields.