Buscar Contato

GET /external/v1/contacts/:id

Recupera os detalhes de um contato especifico pelo ID, incluindo notas e atribuicao de marketing (UTMs / primeiro e ultimo toque).

Autenticacao

Requer permissao contacts:read.

Parametros de Caminho

Parametro	Tipo	Obrigatorio	Descricao
id	string	Sim	Identificador unico do contato

Requisicao

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

Resposta

{
  "success": true,
  "data": {
    "id": "cnt_abc123def456",
    "name": "John Doe",
    "email": "john@example.com",
    "phone": "+5511999999999",
    "company": "Acme Inc",
    "title": "CEO",
    "location": "Sao Paulo, BR",
    "linkedin_profile_url": "https://linkedin.com/in/johndoe",
    "source": "LinkedIn",
    "source_channel": "linkedin",
    "custom_fields": {
      "industry": "Tecnologia",
      "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": "Conheci no evento de SaaS", "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"
    }
  }
}

Campos de Resposta

Campo	Tipo	Descricao
id	string	Identificador unico do contato
name	string	Nome completo
email	string	E-mail
phone	string	Telefone
company	string	Empresa
title	string	Cargo/posicao
location	string	Localizacao
linkedin_profile_url	string	URL do perfil no LinkedIn
source	string	Rotulo da origem do lead
source_channel	string	Canal de origem
custom_fields	object	Pares chave-valor de campos customizados
last_interaction	string	Timestamp ISO 8601 da ultima interacao
tags	array	Objetos de tag (id, name, color)
notes	array	Notas do contato (id, note, created_at)
attribution	object	Atribuicao de marketing (nullable quando nenhum toque foi capturado)
attribution.first_utm_*	string	Parametros UTM do primeiro toque
attribution.first_channel	string	Classificacao de canal do primeiro toque
attribution.first_landing_url	string	URL da primeira landing page
attribution.first_touch / last_touch	object	Blobs crus de primeiro/ultimo toque (UTMs, click ids, referrer...)
attribution.touch_count	integer	Numero de toques capturados

Erros

Status	Codigo	Descricao
404	NOT_FOUND	Contato com este ID nao encontrado