---
title: "Get contact"
method: GET
path: "/contacts/{email}"
tags: ["Contacts"]
---

# Get contact

`GET /contacts/{email}`

## Request

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

Retrieve a contact by email.

## Path parameters

- `email` string, email, required

## Headers

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

## Response `200`

Contact details

- Contact
  - `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
  - `firstConversionEvent` object, nullable
  - `segmentedLists` SegmentedList[]
    - `id` string, uuid
    - `name` string
    - `createdAt` string, date-time
  - `deals` Deal[]
    - `id` string, uuid
    - `pipelineId` string, uuid
    - `stageId` string, uuid
    - `createdAt` string, date-time
    - `updatedAt` string, date-time
    - `deletedAt` string, date-time, nullable
  - `createdAt` string, date-time
  - `attributes` object

## Other responses

- `403`: Invalid or missing API key
- `404`: Contact not found

---

[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)