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

# List contacts

> List contacts in the current account

Returns a paginated list of contacts in the account associated with the API Key.

```http theme={null}
GET https://api.sendify.dingstore.cn/dmx/v2/contacts
```

## Authentication

```http theme={null}
Authorization: Bearer YOUR_API_KEY
```

## Query parameters

| Parameter | Type | Required | Default | Description |
| - | - | - | - | - |
| `pageNo` | `number` | No | `1` | Positive page number. Omission or `0` uses the default; negative values fail |
| `pageSize` | `number` | No | `50` | Contacts per page, from `1` to `1500`. Omission or `0` uses the default |

## Request example

```bash theme={null}
curl -G "https://api.sendify.dingstore.cn/dmx/v2/contacts" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "pageNo=1" \
  --data-urlencode "pageSize=50"
```

## Success response

| Field | Type | Description |
| - | - | - |
| `contacts` | `array<object>` | Contacts on the current page |
| `contacts[].firstName` | `string` | First name; may be empty |
| `contacts[].lastName` | `string` | Last name; may be empty |
| `contacts[].company` | `string \| null` | Company |
| `contacts[].position` | `string` | Job title |
| `contacts[].source` | `string` | `import`, `user_add`, or `open_api` |
| `contacts[].createTime` | `string (date-time)` | Creation time in RFC 3339 UTC |
| `contacts[].customFields` | `array<object>` | Custom fields |
| `contacts[].lastOpenTime` | `string (date-time)` | Most recent campaign-open time when available |
| `contacts[].email` | `string` | Unique contact email in the current account |
| `contacts[].tagNames` | `array<string>` | Tag names |
| `totalCounts` | `number (int32)` | Total matching contacts |
| `totalPages` | `number (int32)` | Total pages; `0` when there are no contacts |

## Error responses

| HTTP status | Meaning |
| - | - |
| `400` | Invalid `pageNo` or `pageSize` |
| `401` | Missing or invalid Bearer API Key |
| `403` | The API Key lacks permission |
| `500` | Internal service error |


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