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

> Lista os membros ativos que fazem aniversário num mês e a idade que completam

Lista os membros ativos de uma empresa que fazem aniversário em um determinado mês, junto com a idade que completarão naquele ano.

O resultado traz nome, dia do aniversário, idade nova, ano de referência e o ID do membro, este último útil para cruzar com outras consultas.

<Note>
  Por proteção de dados, a **data de nascimento completa e o CPF não são retornados**. Você recebe apenas o dia do mês e a idade nova.
</Note>

## Parâmetros

| Parâmetro | Obrigatório | Descrição                                                   |
| --------- | ----------- | ----------------------------------------------------------- |
| `cnpj`    | Sim         | CNPJ da empresa, com ou sem pontuação.                      |
| `mes`     | Não         | Mês do aniversário, de 1 a 12. Se omitido, usa o mês atual. |
| `limite`  | Não         | Máximo de linhas retornadas. Padrão 50, máximo 500.         |

## Limites e omissões

A lista é montada cruzando a busca de membros com a data de nascimento de cada um, e esse cruzamento tem tetos:

* a busca para em **100 páginas de 500 membros**;
* a consulta de data de nascimento para em **1 000 membros**;
* membros sem data de nascimento cadastrada, ou cujo detalhe não pôde ser consultado, são **omitidos do resultado**.

Sempre que algum desses tetos é atingido, a resposta diz explicitamente o que ficou de fora. Uma lista de aniversariantes não é, portanto, garantia de completude em empresa grande.

<Note>
  O **ano de referência é sempre o ano corrente** (fuso de São Paulo), inclusive ao pedir um mês já passado. Perguntar pelos aniversariantes de março em setembro devolve a idade que cada um completou em março **deste ano**, não de um ano anterior.
</Note>

## Exemplos de perguntas

* "Quais membros ativos fazem aniversário este mês na empresa de CNPJ 12.345.678/0001-95?"
* "Liste os aniversariantes de setembro e a idade nova deles"
* "Quem muda de faixa etária em agosto?"