Visão geral
A API retorna, em JSON, a condição geral vigente de cada célula (seguradora × ramo), incluindo o número do processo SUSEP, a versão, a data de vigência e o link do PDF.
Base URL: https://cg-api.masterparceria.com.br
Autenticação
Toda requisição exige uma chave de API, enviada no cabeçalho x-api-key. Para obter sua chave, solicite à Master Parceria.
curl -H "x-api-key: SUA_CHAVE" \ https://cg-api.masterparceria.com.br/v1/cg/ramos
Sem chave válida, a API responde 401. Há um limite de 60 requisições por minuto por chave (excedido → 429).
Endpoints
Lista os ramos que possuem CG vigente.
{
"total": 29,
"dados": [
{ "ramo_cod": "10", "ramo": "AUTOMOVEL", "seguradoras": 20 }
]
}
Retorna as CGs vigentes. Aceita filtros opcionais:
| Parâmetro | Exemplo | Descrição |
|---|---|---|
ramo | ?ramo=10 | Código do ramo |
seguradora | ?seguradora=12 | Código da seguradora |
GET /v1/cg?ramo=10
{
"fonte": "SUSEP (agregado por Master Parceria - cortesia)",
"gerado_em": "2026-09-17T21:49:39Z",
"total": 20,
"dados": [
{
"seguradora_cod": "10",
"seguradora": "PORTO",
"ramo_cod": "10",
"ramo": "AUTOMOVEL",
"processo_susep": "15414.100233/2004-59",
"versao": "511424",
"data_vigencia": "2026-09-01",
"pdf_url": "https://.../documentos/....pdf",
"hash": "1a92bf08...",
"atualizado_em": "2026-09-01T06:00:24",
"verificado_em": "2026-09-17T06:01:47"
}
]
}
Campos da resposta
seguradora / seguradora_cod | Nome e código da seguradora |
ramo / ramo_cod | Nome e código do ramo |
processo_susep | Número do processo SUSEP da condição geral |
versao | Identificador da versão vigente na SUSEP |
data_vigencia | Data de início de comercialização da versão vigente |
pdf_url | Link direto para o PDF da condição geral |
hash | SHA-256 do arquivo (para verificação de integridade) |
verificado_em | Última verificação automática contra a SUSEP |
Códigos de erro
| Código | Significado |
|---|---|
401 | Chave ausente, inválida ou inativa |
429 | Limite de requisições excedido (60/min) |
500 | Falha temporária ao consultar |
Erros retornam JSON no formato { "erro": "...", "detalhe": "..." }.
Termo de uso
Ao utilizar esta API, o parceiro concorda que:
- O serviço é uma cortesia, fornecido em regime best-effort, sem garantia de disponibilidade, exatidão ou continuidade.
- A fonte oficial e definitiva das condições gerais é a SUSEP; em caso de divergência, prevalece o documento oficial.
- A chave de API é pessoal e intransferível; seu uso é de responsabilidade do parceiro.
- É vedada a revenda dos dados ou o repasse do acesso a terceiros sem autorização.
- A Master Parceria pode revogar chaves ou alterar/encerrar o serviço a qualquer momento.