ReferênciaContatos
Obter contato
GET /contacts/{id} — retorna um contato único por UUID, escopado pela organização da API key.
GET
/contacts/{id}BetaEscopo necessário: contacts:read
Retorna um contato único por UUID. A organização é resolvida pela API key — um id de outra organização retorna 404.
Endpoint
GET https://crm.oficinamartech.com/api/v1/contacts/{id}Exemplo
curl -s "https://crm.oficinamartech.com/api/v1/contacts/f47ac10b-58cc-4372-a567-0e02b2c3d479" \
-H "Authorization: Bearer crm_live_SEU_PREFIXO_SEU_SEGREDO"Resposta 200
{
"data": {
"id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
"organization_id": "0a1b2c3d-4e5f-6789-abcd-ef0123456789",
"name": "Maria Silva",
"email": "maria@example.com",
"phone": "+5511999999999",
"phone_e164": "+5511999999999",
"source": "api",
"custom_fields": { "plano": "Pro" },
"created_at": "2026-06-10T14:03:22.000Z",
"updated_at": "2026-07-01T09:12:45.000Z"
}
}Erros
| Status | Código | Quando |
|---|---|---|
400 | invalid_id | O id informado não é um UUID. |
401 | missing_api_key / invalid_api_key | API key ausente, inválida, expirada ou revogada. |
403 | missing_scope | A chave não tem o escopo contacts:read. |
404 | not_found | Contato inexistente ou de outra organização. |
429 | rate_limited | Acima de 120 req/min por chave ou por organização. |
500 | — | Erro interno. |