Skip to main content

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âmetroTipoObrigatórioDescrição
ccbNumberstring✅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ódigoHTTPDescrição
VALIDATION_ERROR400ccbNumber não informado.
NOT_FOUND404Nenhuma apólice encontrada para a CCB informada.
AMBIGUOUS_CCB409Mais de uma apólice corresponde à CCB; use GET /v2/policies/{id}.