V1CreateShareholderRestBody

name stringrequired

Shareholder full name (razão social for PJ, nome completo for PF).

document stringrequired

Document number (CPF for PF, CNPJ for PJ). Only numbers.

type stringrequired

Possible values: [PARTNER, ATTORNEY, ADMINISTRATOR, OTHER]

Shareholder type/qualification in the company (equity structure).

participation_percentage number

Participation percentage in company capital (participação acionária). Range: 0.00 to 100.00.

Note: This represents the equity stake in the company. If this shareholder is a PJ (legal person), you will need to create legal representatives (PFs) and link them to this shareholder via the legal representatives endpoint.

zip_code string

Zip code (CEP) of the shareholder address. Used in CAF validation for QSA structure.