v1

latestOpenAPI 3.0.02026-07-2464438356.8 KB
Associated Persons

Create an associated person

Creates an associated person — a beneficial owner or control person — and attaches them to the organization. To include them in a business compliance review, reference their ID from the business associated persons attestation. An organization may have one control person and up to four beneficial owners. The same individual can act as both.

post/api/compliance/{organizationId}/associated-persons

Path parameters

organizationIdstring uuid required

Request body

relationshipsstring[] required

The relationship(s) of this person to the business.

  • BENEFICIAL_OWNER — holds an ownership stake in the business. Declare owners with 25% or more ownership; if there are no owners at 25% or more, report the owner with the highest ownership percentage. The exact ownershipPercentage is set on the personal-info attestation.
  • CONTROL_PERSON — has significant management responsibility.

A person can hold both roles.

Example request

{
  "relationships": [
    "BENEFICIAL_OWNER"
  ]
}

Response

Associated person created.

associatedPersonIdstring uuid required

Associated person UUID.

relationshipsstring[] required

The relationship(s) of this associated person to the business. A person can be both a beneficial owner and a control person.

createdAtstring required

ISO 8601 timestamp when the associated person was created.

updatedAtstring required

ISO 8601 timestamp when the associated person was last updated.

Example response

{
  "relationships": [
    "BENEFICIAL_OWNER"
  ],
  "createdAt": "2026-02-24T12:00:00.000Z",
  "updatedAt": "2026-02-24T12:00:00.000Z",
  "uploadedAttestations": []
}