> ## 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_empresas

> Lista as empresas às quais você tem acesso, preservando a hierarquia de matriz, filiais e PJs

Lista as empresas acessíveis à sua conta, preservando a hierarquia devolvida pela Pipo.

As empresas no nível principal são **matrizes**. Dentro de cada matriz aparecem:

* **filiais**: as subsidiárias da matriz;
* **PJs**: empresas vinculadas ao contrato de serviço.

## Parâmetros

| Parâmetro | Obrigatório | Descrição                                                                       |
| --------- | ----------- | ------------------------------------------------------------------------------- |
| `relacao` | Não         | Filtra por tipo: `matriz`, `filial` ou `pj`.                                    |
| `matriz`  | Condicional | Matriz por nome, CNPJ ou UUID. **Obrigatório** ao filtrar por `filial` ou `pj`. |
| `produto` | Não         | Nome do produto, por exemplo `Plano Essencial`. Aceita parte do nome.           |

<Note>
  O filtro por produto procura o nome do produto na matriz, identifica o produto correspondente e devolve a matriz junto com as filiais e PJs que o possuem.
</Note>

## Exemplos de perguntas

* "Quais empresas eu tenho acesso na Pipo?"
* "Quais são as filiais da Acme Inc.?"
* "Quais PJs estão vinculadas a esta matriz?"
* "Quais empresas têm o produto Plano Essencial?"