---
title: "List contacts"
method: GET
path: "/contacts"
tags: ["Contacts"]
---

# List contacts

`GET /contacts`

## Request

- Base URL: `https://connect.pingback.com/v2`
- URL: `https://connect.pingback.com/v2/contacts`
- Auth: API key in header `x-api-key`

Returns a paginated list of contacts. Each page contains 10 results.

## Query parameters

- `page` integer, required

## Headers

- `developer-mode` boolean, required
- `x-api-key` string, required

## Response `200`

Paginated list of contacts

- ContactListResponse
  - `page` integer
  - `total` integer
  - `data` ContactListItem[]
    - `id` string, uuid
    - `email` string, email
    - `status` 'active' | 'inactive' | 'invalid' | 'unverified' | 'unsubscribed' | 'bounced' | 'complained'
    - `source` 'Form' | 'PublicApi' | 'Import' | 'User' | 'Blog' | 'System' | 'Webhook'
    - `origin` ContactOrigin
      - `url` string
      - `utmSource` string
      - `utmCampaign` string
      - `utmMedium` string
      - `utmTerm` string
      - `utmContent` string
    - `segmentedListsIds` string[]
    - `createdAt` string, date-time
    - `attributes` object

## Other responses

- `403`: Invalid or missing API key

---

[API](https://skmtc.dev/pingback/apis/pingback-connect-api.md) · [All operations](https://skmtc.dev/pingback/apis/pingback-connect-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pingback/apis/pingback-connect-api/revisions/92ac3e0da8fe?raw)