> ## Documentation Index
> Fetch the complete documentation index at: https://docs.piposaude.com.br/llms.txt
> Use this file to discover all available pages before exploring further.

# listar_operadoras_da_empresa

> Lista as operadoras com dados disponíveis para uma empresa e o período coberto

Lista as operadoras de saúde que têm dados disponíveis para uma empresa, junto com o período coberto por cada uma.

<Note>
  Use esta ferramenta **antes** das demais consultas de saúde quando não souber qual operadora ou período consultar. Ela é a forma de descobrir os valores válidos de `carrier_name`.
</Note>

## Parâmetros

| Parâmetro    | Obrigatório | Descrição                |
| ------------ | ----------- | ------------------------ |
| `company_id` | Sim         | UUID da empresa na Pipo. |

<Warning>
  A lista mostra operadoras **com dados publicados**, o que não garante que a operadora esteja ativa hoje. Dado histórico e contrato vigente são coisas diferentes.
</Warning>

## Quando informar `carrier_name` é obrigatório

As demais ferramentas de saúde aceitam `carrier_name` como opcional, mas o que acontece ao omiti-lo depende da empresa:

| Operadoras com dados | Ao omitir `carrier_name`                                                  |
| -------------------- | ------------------------------------------------------------------------- |
| Uma                  | A operadora é escolhida automaticamente e a consulta segue.               |
| Mais de uma          | A consulta **falha** e devolve a lista de operadoras para você escolher.  |
| Nenhuma              | A consulta **falha**: não há dados de saúde publicados para essa empresa. |

Ou seja: a omissão não é um atalho universal. Em empresa multi-operadora, informar o nome é obrigatório, e é para isso que esta ferramenta existe.

<Note>
  Mesmo quando a escolha automática funciona, ela não confirma que aquela seja a operadora atual do contrato — pode ser uma base histórica. As respostas trazem um contexto de consulta com `carrier_selection` e `data_status` indicando exatamente isso.
</Note>

## Exemplos de perguntas

* "Quais operadoras a empresa X tem?"
* "Liste as operadoras dessa empresa e o período disponível"