---
title: "List Contacts"
method: GET
path: "/v4/accounts/{voip_id}/extensions/{extension_id}/contacts"
tags: ["Extension Contacts"]
---

# List Contacts

`GET /v4/accounts/{voip_id}/extensions/{extension_id}/contacts`

## Request

- Base URL: `https://api.phone.com`
- URL: `https://api.phone.com/v4/accounts/{voip_id}/extensions/{extension_id}/contacts`
- Auth: HTTP bearer

Show a list of address book contacts.

## Path parameters

- `voip_id` integer, required
- `extension_id` integer, required

## Query parameters

- `offset` integer
- `limit` integer
- `sort[id]` 'asc' | 'desc'
- `include_subaccounts` integer
- `filters[name]` string
- `filters[group_id]` string
- `filters[phone]` string
- `filters[updated_at]` string
- `filters[include_trashed]` string
- `filters[duplications]` string
- `filters[deleted_at]` string
- `filters[modified_at]` string
- `mode` 'brief' | 'full'

## Response `200`

OK

- ListResponse
  - `filters` object
  - `sort` object
  - `total` integer
  - `limit` integer
  - `offset` integer
  - `items` object[]

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `402`: Payment Required
- `403`: Forbidden
- `404`: Not Found
- `409`: Conflict
- `422`: Validation failed
- `429`: Too Many Requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/phone/apis/phoenix-api-by-phone-com.md) · [All operations](https://skmtc.dev/phone/apis/phoenix-api-by-phone-com/llms.txt) · [OpenAPI document](https://skmtc.dev/phone/apis/phoenix-api-by-phone-com/revisions/a6274ad4319c?raw)