## List

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

Retrieve a list of contacts for the authenticated account

### Query Parameters

- `cid: optional string`

  Filter by contact ID

- `limit: optional number`

  Maximum number of contacts to return

- `offset: optional number`

  Number of contacts to skip

- `order_by: optional string`

  Field to sort by

- `order_direction: optional "asc" or "desc"`

  Sort direction

  - `"asc"`

  - `"desc"`

- `phone_number: optional string`

  Filter by phone number

### Returns

- `assigned_to_email: optional string`

  Email of assigned user

- `company_name: optional string`

  Company name

- `created_at: optional string`

  When the contact was created

- `custom_variables: optional map[string]`

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

- `first_name: optional string`

  First name

- `last_name: optional string`

  Last name

- `phone: optional string`

  Phone number in E.164 format

- `sendblue_number: optional string`

  Associated Sendblue phone number

- `tags: optional array of string`

  Tags associated with the contact

- `verified: optional boolean`

  Whether the contact is verified

### Example

```http
curl https://api.sendblue.co/api/v2/contacts \
    -H "sb-api-key-id: $SENDBLUE_API_API_KEY" \
    -H "sb-api-secret-key: $SENDBLUE_API_API_SECRET"
```