Buscar Contato

GET /external/v1/contacts/:id

Recupera os detalhes de um contato especifico pelo ID.

Autenticacao

Requer permissao contacts:read.

Parametros de Caminho

Parametro	Tipo	Obrigatorio	Descricao
id	string	Sim	O 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",
    "position": "CEO",
    "source": "linkedin",
    "linkedin_url": "https://linkedin.com/in/johndoe",
    "tags": ["prospect", "decision-maker"],
    "custom_fields": {
      "industry": "Technology",
      "company_size": "50-200"
    },
    "created_at": "2024-01-15T10:30:00Z",
    "updated_at": "2024-01-20T14:00:00Z"
  }
}

Campos da Resposta

Campo	Tipo	Descricao
id	string	Identificador unico do contato
name	string	Nome completo
email	string	Endereco de e-mail
phone	string	Numero de telefone
company	string	Nome da empresa
position	string	Cargo/posicao
source	string	Origem do lead
linkedin_url	string	URL do perfil no LinkedIn
tags	array	Array de strings de tags
custom_fields	object	Pares chave-valor de campos personalizados
created_at	string	Timestamp de criacao ISO 8601
updated_at	string	Timestamp da ultima atualizacao ISO 8601

Erros

Status	Codigo	Descricao
404	NOT_FOUND	Contato com este ID nao foi encontrado