Get Contact

GET /external/v1/contacts/:id

Retrieves details of a specific contact by ID, including notes and marketing attribution (UTMs / first & last touch).

Authentication

Requires contacts:read permission.

Path Parameters

Parameter	Type	Required	Description
id	string	Yes	The unique identifier of the contact

Request

cURL

curl --request GET \
  --url "https://app.getraze.com/external/v1/contacts/cnt_abc123def456" \
  --header "X-API-Key: YOUR_API_KEY"

Node.js

const axios = require('axios');

const contactId = 'cnt_abc123def456';

const response = await axios.get(
  `https://app.getraze.com/external/v1/contacts/${contactId}`,
  { headers: { 'X-API-Key': 'YOUR_API_KEY' } }
);

console.log(response.data);

Python

import requests

contact_id = 'cnt_abc123def456'

response = requests.get(
    f'https://app.getraze.com/external/v1/contacts/{contact_id}',
    headers={'X-API-Key': 'YOUR_API_KEY'}
)

print(response.json())

Response

{
  "success": true,
  "data": {
    "id": "cnt_abc123def456",
    "name": "John Doe",
    "email": "john@example.com",
    "phone": "+5511999999999",
    "company": "Acme Inc",
    "title": "CEO",
    "location": "São Paulo, BR",
    "linkedin_profile_url": "https://linkedin.com/in/johndoe",
    "source": "LinkedIn",
    "source_channel": "linkedin",
    "custom_fields": {
      "industry": "Technology",
      "company_size": "50-200"
    },
    "last_interaction": "2026-01-20T14:00:00Z",
    "created_at": "2026-01-15T10:30:00Z",
    "updated_at": "2026-01-20T14:00:00Z",
    "tags": [
      { "id": "tag_01", "name": "prospect", "color": "blue" }
    ],
    "notes": [
      { "id": "note_01", "note": "Met at the SaaS conference", "created_at": "2026-01-16T09:00:00Z" }
    ],
    "attribution": {
      "first_utm_source": "google",
      "first_utm_medium": "cpc",
      "first_utm_campaign": "black_friday",
      "first_channel": "paid",
      "first_landing_url": "https://acme.com/lp-demo",
      "first_touch": { "utm_source": "google", "gclid": "abc123" },
      "last_touch": { "utm_source": "linkedin" },
      "touch_count": 4,
      "first_seen_at": "2026-01-10T08:00:00Z",
      "last_seen_at": "2026-01-19T18:00:00Z"
    }
  }
}

Response Fields

Field	Type	Description
id	string	Unique contact identifier
name	string	Full name
email	string	Email address
phone	string	Phone number
company	string	Company name
title	string	Job title/position
location	string	Location
linkedin_profile_url	string	LinkedIn profile URL
source	string	Lead source label
source_channel	string	Source channel
custom_fields	object	Custom field key-value pairs
last_interaction	string	ISO 8601 timestamp of the last interaction
tags	array	Tag objects (id, name, color)
notes	array	Contact notes (id, note, created_at)
attribution	object	Marketing attribution (nullable when no touches were captured)
attribution.first_utm_*	string	First-touch UTM parameters
attribution.first_channel	string	First-touch channel classification
attribution.first_landing_url	string	First landing page URL
attribution.first_touch / last_touch	object	Raw first/last touch blobs (UTMs, click ids, referrer…)
attribution.touch_count	integer	Number of captured touches

Errors

Status	Code	Description
404	NOT_FOUND	Contact with this ID was not found