Listar responsáveis cadastrados por CNPJ
GET /contract-responsible
Lista os responsáveis já cadastrados para um CNPJ, pra o parceiro conferir se já existe algum
antes de cadastrar de novo.
Query params
| Param | Tipo | Obrigatório | Regras |
|---|---|---|---|
cnpj | string | Sim | Exatamente 14 dígitos, sem pontuação, CNPJ válido |
Sucesso — 200 OK
[
{
"id": "8f14e0a1-2b3c-4d5e-9f01-abcdef123456",
"documentNumber": "12345678909",
"name": "Maria Silva",
"email": "[email protected]",
"phoneNumber": "11999999999",
"birthDate": "1990-05-10"
}
]Lista vazia ([]) significa que nenhum responsável foi cadastrado ainda pra esse CNPJ.
Erros mapeados
| HTTP | code | Quando ocorre |
|---|---|---|
| 400 | — | cnpj ausente ou com formato/dígito verificador inválido |
| 404 | — | Parceiro não tem vínculo com esse cnpj (ver seção 2, escopo por parceiro) |
| 500 | CONTRACT_RESPONSIBLE_INTEGRATION_FAILURE | Falha de comunicação interna — repetir com backoff |
Updated about 1 hour ago
