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

# Get SIP Call Logs

> Retrieve SIP call logs for a phone number with cursor-based pagination.

### Headers

**authorization** `string` *required*

Your API key for authentication.

### Query Parameters

**phone\_number** `string` *required*

The phone number to fetch call logs for. Must be in E.164 format.

**limit** `number`

Maximum number of calls to return. Default: 50.

**before** `string`

Cursor for pagination. Pass the `call_id` of the last call from the previous page to fetch the next page.

### Response

**calls** `array`

Array of call records. Each includes:

* `call_id` (string) — Unique SIP Call-ID
* `direction` (string) — `"inbound"` or `"outbound"`
* `from` (string) — Caller number
* `to` (string) — Callee number
* `status` (string) — Final SIP status (e.g., `"200 OK"`, `"486 Busy"`)
* `sip_code` (number) — SIP response code
* `duration_seconds` (number) — Call duration
* `started_at` (string) — ISO 8601 timestamp
* `ended_at` (string) — ISO 8601 timestamp
* `source_ip` (string) — Source IP address

```json Example Request theme={null}
curl -X GET 'https://api.bland.ai/v1/sip/calls?phone_number=%2B14150000000&limit=10' \
  -H "Authorization: Bearer <token>"
```

```json Response theme={null}
{
  "data": {
    "calls": [
      {
        "call_id": "abc123@sip.bland.ai",
        "direction": "outbound",
        "from": "+14150000000",
        "to": "+15105551234",
        "status": "200 OK",
        "sip_code": 200,
        "duration_seconds": 45,
        "started_at": "2026-03-09T11:00:00Z",
        "ended_at": "2026-03-09T11:00:45Z",
        "source_ip": "35.80.235.26"
      }
    ]
  },
  "errors": null
}
```

***

Docs for agents: [llms.txt](https://docs.bland.ai/llms.txt)


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