V1CreateShareholderRestBody

name stringrequired

Shareholder full name (corporate name for legal person, full name for natural person).

document stringrequired

Document number (CPF for natural person, CNPJ for legal person). The CNPJ may be alphanumeric.

type stringrequired

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

Shareholder type/qualification in the legal person equity structure.

participation_percentage number

Participation percentage in legal person capital (participacao acionaria). Range: 0.00 to 100.00.

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

zip_code string

Zip code (CEP) of the shareholder address. Used in the validation of the company shareholding structure (QSA).