ReferênciaNegócios
Obter negócio
GET /deals/{id} — retorna um negócio único por UUID, escopado pela organização da API key.
GET
/deals/{id}BetaEscopo necessário: deals:read
Retorna um negócio ú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/deals/{id}Exemplo
curl -s "https://crm.oficinamartech.com/api/v1/deals/9b2e1c40-58cc-4372-a567-0e02b2c3d479" \
-H "Authorization: Bearer crm_live_SEU_PREFIXO_SEU_SEGREDO"Resposta 200
{
"data": {
"id": "9b2e1c40-58cc-4372-a567-0e02b2c3d479",
"organization_id": "0a1b2c3d-4e5f-6789-abcd-ef0123456789",
"pipeline_id": "11111111-2222-3333-4444-555555555555",
"stage_id": "66666666-7777-8888-9999-aaaaaaaaaaaa",
"contact_id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
"title": "Proposta plano Pro",
"value": 1990.0,
"currency": "BRL",
"status": "open",
"source": "api",
"expected_close_date": "2026-07-31",
"metadata": { "campanha": "black-friday" },
"created_via": "api",
"dedup_key": "lead-2026-000123",
"created_at": "2026-06-20T11:00:00.000Z",
"updated_at": "2026-07-01T16:40:10.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 deals:read. |
404 | not_found | Negócio inexistente ou de outra organização. |
429 | rate_limited | Acima de 120 req/min por chave ou por organização. |
500 | — | Erro interno. |