API de Condições Gerais

Consulta das condições gerais (CG) vigentes por ramo e seguradora, mantidas atualizadas automaticamente a partir da SUSEP. Oferecida pela Master Parceria Corretora de Seguros como cortesia a parceiros.

Master Parceria Corretora de Seguros

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

⚠️ Fonte oficial: os documentos são públicos da SUSEP. Esta API é uma conveniência de agregação; a fonte oficial e definitiva é sempre a SUSEP. Serviço oferecido em regime best-effort (sem garantia de disponibilidade).

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

GET/v1/cg/ramos

Lista os ramos que possuem CG vigente.

{
  "total": 29,
  "dados": [
    { "ramo_cod": "10", "ramo": "AUTOMOVEL", "seguradoras": 20 }
  ]
}
GET/v1/cg

Retorna as CGs vigentes. Aceita filtros opcionais:

ParâmetroExemploDescrição
ramo?ramo=10Código do ramo
seguradora?seguradora=12Có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_codNome e código da seguradora
ramo / ramo_codNome e código do ramo
processo_susepNúmero do processo SUSEP da condição geral
versaoIdentificador da versão vigente na SUSEP
data_vigenciaData de início de comercialização da versão vigente
pdf_urlLink direto para o PDF da condição geral
hashSHA-256 do arquivo (para verificação de integridade)
verificado_emÚltima verificação automática contra a SUSEP

Códigos de erro

CódigoSignificado
401Chave ausente, inválida ou inativa
429Limite de requisições excedido (60/min)
500Falha 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.