## List

`contacts.list(ContactListParams**kwargs)  -> ContactListResponse`

**get** `/api/v2/contacts`

Retrieve a list of contacts for the authenticated account

### Parameters

- `cid: Optional[str]`

  Filter by contact ID

- `limit: Optional[int]`

  Maximum number of contacts to return

- `offset: Optional[int]`

  Number of contacts to skip

- `order_by: Optional[str]`

  Field to sort by

- `order_direction: Optional[Literal["asc", "desc"]]`

  Sort direction

  - `"asc"`

  - `"desc"`

- `phone_number: Optional[str]`

  Filter by phone number

### Returns

- `List[Contact]`

  - `assigned_to_email: Optional[str]`

    Email of assigned user

  - `company_name: Optional[str]`

    Company name

  - `created_at: Optional[datetime]`

    When the contact was created

  - `custom_variables: Optional[Dict[str, str]]`

    Custom key-value pairs stored on the contact. Keys are human-readable labels.

  - `first_name: Optional[str]`

    First name

  - `last_name: Optional[str]`

    Last name

  - `phone: Optional[str]`

    Phone number in E.164 format

  - `sendblue_number: Optional[str]`

    Associated Sendblue phone number

  - `tags: Optional[List[str]]`

    Tags associated with the contact

  - `verified: Optional[bool]`

    Whether the contact is verified

### Example

```python
import os
from sendblue_api import SendblueAPI

client = SendblueAPI(
    api_key=os.environ.get("SENDBLUE_API_API_KEY"),  # This is the default and can be omitted
    api_secret=os.environ.get("SENDBLUE_API_API_SECRET"),  # This is the default and can be omitted
)
contacts = client.contacts.list()
print(contacts)
```