sinistralidade_por_filtro - Pipo Public API

Retorna a sinistralidade de uma empresa segmentada por filtros como faixa etária e gênero. É a ferramenta certa para entender qual segmento puxa o custo, e não apenas qual é o número consolidado.

Parâmetros

Parâmetro	Obrigatório	Descrição
`company_id`	Sim	UUID da empresa na Pipo.
`carrier_name`	Não	Nome da operadora, como aparece em `listar_operadoras_da_empresa`. Se você não informar, a ferramenta não busca a sinistralidade. Ela devolve os contratos e as bases publicadas da empresa, para você escolher a operadora.
`start_date`	Não	Mês de início, no formato `YYYY-MM`. Padrão: 11 meses antes do mês atual (uma janela de 12 meses).
`end_date`	Não	Mês de fim, no formato `YYYY-MM`. Padrão: mês atual.

A ferramenta recusa o período quando o início é posterior ao fim. Ela também recusa um intervalo de mais de 36 meses entre o início e o fim.

Exemplos de perguntas

“Qual a sinistralidade por faixa etária na empresa X em 2025?”
“Compare a sinistralidade entre homens e mulheres na empresa X”