> ## Documentation Index
> Fetch the complete documentation index at: https://docs.burki.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Filter Calls

Burki does not expose a separate full-text `/calls/search` endpoint. Use the [List Calls](/api-reference/calls/list) endpoint with filter query parameters to find calls by phone number, call SID, assistant name, status, assistant, date range, or duration.

### Query Parameters

* `customer_phone` (string, optional): Filter by customer phone number. Partial matches are supported after phone normalization.
* `call_sid` (string, optional): Filter by Burki call SID / provider call identifier. Partial matches are supported.
* `assistant_name` (string, optional): Filter by assistant name. Partial matches are supported, including deleted-assistant snapshots.
* `status` (string, optional): Filter by call status.
* `assistant_id` (integer, optional): Filter by assistant ID.
* `date_from` (string, optional): Filter calls started on or after this ISO timestamp.
* `date_to` (string, optional): Filter calls started on or before this ISO timestamp.
* `skip` (integer, optional, default: 0): Number of records to skip.
* `limit` (integer, optional, default: 100): Maximum number of records to return.

Filters are combined with AND semantics.

### Response

The response is the same paginated object returned by the [List Calls](/api-reference/calls/list) endpoint.

```json Response theme={null}
{
  "items": [
    {
      "id": 101,
      "call_sid": "CAxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
      "assistant_id": 123,
      "assistant_name": "ServiceBot",
      "flow_name": null,
      "to_phone_number": "+15551234567",
      "customer_phone_number": "+15559876543",
      "status": "completed",
      "started_at": "2023-10-30T10:00:00Z",
      "ended_at": "2023-10-30T10:05:00Z",
      "duration": 300,
      "call_meta": {
        "customer_id": "cust_abc123"
      },
      "total_cost": 0.05,
      "llm_cost": 0.02,
      "tts_cost": 0.01,
      "stt_cost": 0.01,
      "telephony_cost": 0.01,
      "cost_currency": "USD"
    }
  ],
  "total": 1,
  "skip": 0,
  "limit": 100
}
```
