Skip to main content

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