v58

latestOpenAPI 3.0.0raw.githubusercontent.com2026-08-073053701.0 MB

Reach: Contacts

Get contact details

Get the full details of a single contact.

Alongside the contact's own attributes this returns the tags assigned to it and the values it holds for the profile's custom contact fields.

get/api/reach/v1/profiles/{profileUuid}/contacts/{contactUuid}

Path parameters

profileUuidstring required

Example:550e8400-e09b-41d4-a716-400055000000

Profile uuid parameter

contactUuidstring uuid required

Example:550e8400-e29b-41d4-a716-446655440000

Contact uuid parameter

Response

Success response

uuidstring

emailstring

namestring nullable

surnamestring nullable

phonestring nullable

subscription_status'subscribed' | 'unsubscribed' | 'confirmed' | 'pending'

subscribed_atstring date-time nullable

unsubscribed_atstring date-time nullable

created_atstring date-time nullable

domainstring nullable

notestring nullable

Example response

{
  "uuid": "550e8400-e29b-41d4-a716-446655440000",
  "email": "john.doe@example.com",
  "name": "John",
  "surname": "Doe",
  "phone": "+14155552671",
  "subscription_status": "subscribed",
  "subscribed_at": "2023-01-01T00:00:00Z",
  "unsubscribed_at": "2023-06-15T00:00:00Z",
  "created_at": "2022-12-01T00:00:00Z",
  "domain": "example.com",
  "source": "api",
  "note": "VIP customer",
  "tags": [
    {
      "uuid": "550e8400-e29b-41d4-a716-446655440000",
      "type": "custom",
      "value": "Newsletter",
      "created_at": "2025-02-27T11:54:22Z"
    }
  ],
  "fields": [
    {
      "uuid": "550e8400-e29b-41d4-a716-446655440000",
      "type": "text",
      "label": "Job title",
      "slug": "job_title",
      "value": "Developer",
      "options": [
        {
          "uuid": "550e8400-e29b-41d4-a716-446655440000",
          "label": "Gold"
        }
      ]
    }
  ]
}