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

# List calls

> List all calls for the authenticated user with filtering options

This endpoint allows you to list all calls belonging to the authenticated user with various filtering options.

### Query Parameters

**status** `string`

Filter calls by status. Possible values: `initiated`, `ringing`, `busy`, `in-progress`, `ended`, `completed`, `ended_by_customer`, `ended_by_assistant`, `no-answer`, `failed`

**type** `string`

Filter calls by type. Possible values: `inbound`, `outbound`, `web`

**phone\_number** `string`

Filter calls by client phone number

**assistant\_id** `integer`

Filter calls by assistant ID

**campaign\_id** `integer`

Filter calls by campaign ID

**date\_from** `string`

Filter calls from this date (YYYY-MM-DD format)

**date\_to** `string`

Filter calls until this date (YYYY-MM-DD format)

**per\_page** `integer`

Number of calls per page (1-100, default: 15)

**page** `integer`

Page number (default: 1)

### Response fields

**data** `array`

**properties**

**id** `integer`

The unique identifier of the call

**assistant\_name** `string`

The name of the assistant that handled the call

**campaign\_name** `string`

The name of the campaign this call belongs to (if applicable)

**type** `string`

The type of the call (`inbound`, `outbound`, or `web`)

**duration** `integer`

The duration of the call in seconds

**assistant\_phone\_number** `string`

The phone number used by the assistant

**client\_phone\_number** `string`

The phone number of the client

**status** `string`

The current status of the call

**transcript** `string`

The transcript of the call conversation

**variables** `object`

Variables collected during the call

**evaluation** `object`

Evaluation data for the call performance

**webhook\_response** `object`

Response from any configured webhooks

**carrier\_cost** `number`

The cost charged by the carrier for this call

**total\_cost** `number`

The total cost of the call including all fees

**answered\_by** `string`

Who answered the call (`human`, `machine`, or `unknown`)

**recording\_url** `string`

URL to the call recording (if available and enabled)

**created\_at** `string`

The date and time when the call was created

**updated\_at** `string`

The date and time when the call was last updated

**current\_page** `integer`

The current page number

**per\_page** `integer`

Number of items per page

**total** `integer`

Total number of calls matching the criteria

**last\_page** `integer`

The last page number

```json 200 Response theme={null}
{
  "current_page": 1,
  "data": [
    {
      "id": 123,
      "assistant_name": "Sales Assistant",
      "campaign_name": "Q4 Outreach Campaign",
      "type": "outbound",
      "duration": 245,
      "assistant_phone_number": "+1234567890",
      "client_phone_number": "+1987654321",
      "status": "completed",
      "transcript": "Hello, this is Sarah from Receptonic. How are you doing today?...",
      "variables": {
        "customer_name": "John Smith",
        "interest_level": "high",
        "follow_up_date": "2025-08-15"
      },
      "evaluation": {
        "sentiment": "positive",
        "outcome": "qualified_lead",
        "score": 8.5
      },
      "webhook_response": {
        "status": "success",
        "data": {
          "crm_contact_id": "abc123"
        }
      },
      "carrier_cost": 0.02,
      "total_cost": 0.025,
      "answered_by": "human",
      "recording_url": "https://app.receptonic.com/recordings/calls/123.mp3",
      "created_at": "2025-08-04 14:30:00",
      "updated_at": "2025-08-04 14:34:05"
    }
  ],
  "first_page_url": "https://app.receptonic.com/api/user/calls?page=1",
  "from": 1,
  "last_page": 10,
  "last_page_url": "https://app.receptonic.com/api/user/calls?page=10",
  "links": [
    {
      "url": null,
      "label": "« Previous",
      "active": false
    },
    {
      "url": "https://app.receptonic.com/api/user/calls?page=1",
      "label": "1",
      "active": true
    },
    {
      "url": "https://app.receptonic.com/api/user/calls?page=2",
      "label": "2",
      "active": false
    }
  ],
  "next_page_url": "https://app.receptonic.com/api/user/calls?page=2",
  "path": "https://app.receptonic.com/api/user/calls",
  "per_page": 15,
  "prev_page_url": null,
  "to": 15,
  "total": 150
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.