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

# Sócios e administradores

> Ferramenta MCP list_business_officers da Base39.

Retorna os sócios e administradores com CPF ou CNPJ completo, percentual de participação, qualificação e data de entrada, conforme informados. Campos não disponibilizados pela fonte ficam ausentes. Preço: R\$ 3,04. Valor por consulta.

## Ferramenta

`list_business_officers`

## Exemplo de chamada

```json theme={null}
{
  "method": "tools/call",
  "params": {
    "name": "list_business_officers",
    "arguments": {
      "document": "00000000000191"
    }
  }
}
```

## Exemplo de resultado

> [tab] Resumo
>
> ```markdown theme={null}
> ### Quadro societário
>
> Nome | Documento | Qualificação | Entrada | Participação (%)
> --- | --- | --- | --- | ---
> Pessoa Exemplo | 52998224725 | SOCIO | 2008-09-11 | 50
> ```

> [tab] Dados
>
> ```json theme={null}
> {
>   "object": "list",
>   "data": [
>     {
>       "object": "officer",
>       "document": "52998224725",
>       "name": "Pessoa Exemplo",
>       "qualification": "SOCIO",
>       "joined_at": "2008-09-11",
>       "ownership_percent": 50
>     }
>   ]
> }
> ```

> [accordion] Parâmetros
>
> ```json theme={null}
> {
>   "$schema": "https://json-schema.org/draft/2020-12/schema",
>   "type": "object",
>   "properties": {
>     "document": {
>       "type": "string",
>       "pattern": "^(?:[0-9A-Za-z]{12}\\d{2}|[0-9A-Za-z]{2}\\.[0-9A-Za-z]{3}\\.[0-9A-Za-z]{3}\\/[0-9A-Za-z]{4}-\\d{2})$",
>       "description": "CNPJ completo, com ou sem pontuação.",
>       "title": "CNPJ"
>     }
>   },
>   "required": [
>     "document"
>   ],
>   "additionalProperties": false,
>   "examples": [
>     {
>       "document": "00000000000191"
>     }
>   ]
> }
> ```

> [accordion] Resultado
>
> ```json theme={null}
> {
>   "$schema": "https://json-schema.org/draft/2020-12/schema",
>   "type": "object",
>   "properties": {
>     "object": {
>       "type": "string",
>       "const": "list",
>       "description": "Coleção de objetos Base39."
>     },
>     "data": {
>       "type": "array",
>       "items": {
>         "type": "object",
>         "properties": {
>           "object": {
>             "type": "string",
>             "const": "officer",
>             "description": "Tipo do objeto: sócio ou administrador."
>           },
>           "document": {
>             "description": "CPF ou CNPJ completo do sócio, quando identificado com segurança; ausente quando indisponível.",
>             "type": "string",
>             "pattern": "^(?:\\d{11}|[A-Z0-9]{12}\\d{2})$"
>           },
>           "name": {
>             "type": "string",
>             "description": "Nome do sócio ou administrador."
>           },
>           "qualification": {
>             "type": "string",
>             "description": "Qualificação societária."
>           },
>           "joined_at": {
>             "type": "string",
>             "format": "date",
>             "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
>             "description": "Data de entrada na sociedade, em YYYY-MM-DD."
>           },
>           "ownership_percent": {
>             "type": "number",
>             "description": "Participação percentual informada pela fonte."
>           }
>         },
>         "required": [
>           "object"
>         ],
>         "additionalProperties": false
>       },
>       "description": "Objetos da coleção."
>     },
>     "next_cursor": {
>       "description": "Cursor opaco da próxima página; ausente ao final.",
>       "type": "string"
>     }
>   },
>   "required": [
>     "object",
>     "data"
>   ],
>   "additionalProperties": false,
>   "examples": [
>     {
>       "object": "list",
>       "data": [
>         {
>           "object": "officer",
>           "document": "52998224725",
>           "name": "Pessoa Exemplo",
>           "qualification": "SOCIO",
>           "joined_at": "2008-09-11",
>           "ownership_percent": 50
>         }
>       ]
>     }
>   ]
> }
> ```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.