Consultar Seguro por CCB
Busca reversa: informe o número da CCB e receba a apólice correspondente. A busca considera tanto a CCB original (1ª contratação) quanto a CCB vigente após uma renegociação, e é restrita às apólices do parceiro autenticado.
Requisição
Endpoint
- Metodo: GET
- Endpoint:
/v2/policies/by-ccb
Parâmetros (Query)
| Parâmetro | Tipo | Obrigatório | Descrição |
|---|---|---|---|
| ccbNumber | string | ✅ | Número da CCB (creditContractId). Codifique caracteres especiais como / na URL. |
Exemplo de requisição
GET /v2/policies/by-ccb?ccbNumber=CCB-12345
Resposta
Retorna o mesmo objeto de Consultar Seguro.
Erros
| Código | HTTP | Descrição |
|---|---|---|
VALIDATION_ERROR | 400 | ccbNumber não informado. |
NOT_FOUND | 404 | Nenhuma apólice encontrada para a CCB informada. |
AMBIGUOUS_CCB | 409 | Mais de uma apólice corresponde à CCB; use GET /v2/policies/{id}. |