OZozav
Customers

Add an associated person (UBO, director, officer, or signer) to a business customer

Adds an associated person - a UBO, director, officer, or authorized signer - to a business customer, for KYB. Supply one or more roles and the person's individual identity block (and ownership_percent for owners). Valid only for business customers. Returns the created AssociatedPerson.

Gender. individual.gender is recorded with the same rules as PATCH and the customer portal. If the customer already has this person (same CPF) with another declared gender and the gender request is closed, the call returns 409 GENDER_ALREADY_DECLARED and the person is not created. Otherwise the value also applies to the customer's other records of the same person.

post/customers/{customer_id}/associated-persons

Request

  • Base URL
    https://developers.ozav.io/v2
  • Auth
    • API key in header X-API-Key
    • or HTTP bearer

Request body

rolesstring[] required

One or more roles this person holds in the business:

  • ubo - ultimate beneficial owner (an owner above the ownership threshold).
  • director - a member of the board or a statutory director.
  • officer - an executive officer (e.g. CEO, CFO).
  • authorized_signer - authorized to act or sign on the account.
ownership_percentnumber

Percentage of the business this person owns, 0-100. Relevant for ubo roles.

emailstring email

Contact email for this person. Optional. At most 254 characters.

Response

Associated person created.

idstring required

Opaque associated-person identifier, prefixed ozav_ap_.

object'associated_person' required

Resource type discriminator; always the literal associated_person.

customer_idstring

The ozav_cus_ id of the business customer this person belongs to.

rolesstring[] required

Roles this person holds - one or more of ubo, director, officer, authorized_signer (see AssociatedPersonCreateRequest.roles).

ownership_percentnumber

Percentage of the business this person owns, 0-100.

emailstring email

Contact email for this person.

created_atstring date-time

When the associated person was added (RFC 3339 / ISO 8601, UTC).

Changes

No recorded changes to this operation across all 1 revision of this API.