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). 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 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 CAF validation for QSA structure.