---
title: "List associated persons"
method: GET
path: "/api/compliance/{organizationId}/associated-persons"
tags: ["Associated Persons"]
---

# List associated persons

`GET /api/compliance/{organizationId}/associated-persons`

Returns all associated persons for the organization, including each associated person's uploaded attestations.

## Path parameters

- `organizationId` string, uuid, required

## Response `200`

Associated persons returned successfully.

- ListAssociatedPersonsResponse
  - `persons` AssociatedPersonResource[], required — All associated persons for the organization.
    - `associatedPersonId` string, uuid, required — Associated person UUID.
    - `relationships` string[], required — The relationship(s) of this associated person to the business. A person can be both a beneficial owner and a control person.
    - `createdAt` string, required — ISO 8601 timestamp when the associated person was created.
    - `updatedAt` string, required — ISO 8601 timestamp when the associated person was last updated.
    - `requiredAttestations` AssociatedPersonAttestationRequirement[] — Attestation types this associated person still needs before the review can be submitted.
      - `attestationType` 'associatedPersonPersonalInfo' | 'associatedPersonContactInfo' | 'associatedPersonResidentialAddress' | 'associatedPersonTaxInfo' | 'associatedPersonIdentityDocument' | 'associatedPersonProofOfAddress' | 'associatedPersonEeaInfo' | 'associatedPersonProofOfSignatoryAuthority', required — Associated person attestation type required before submitting the compliance review.
    - `uploadedAttestations` AssociatedPersonAttestationSummary[], required — Attestations uploaded for this associated person.
      - `attestationType` 'associatedPersonPersonalInfo' | 'associatedPersonContactInfo' | 'associatedPersonResidentialAddress' | 'associatedPersonTaxInfo' | 'associatedPersonIdentityDocument' | 'associatedPersonProofOfAddress' | 'associatedPersonEeaInfo' | 'associatedPersonProofOfSignatoryAuthority', required — Which associated person attestation this summary refers to.
      - `id` string, uuid, required — Unique attestation ID
      - `validationStatus` union, required — Validations lifecycle state for this attestation.
        - AttestationValidationStatusPending — Validations in progress.
          - `type` 'pending', required
        - AttestationValidationStatusApproved — Attestation passed validations.
          - `type` 'approved', required
        - AttestationValidationStatusFailed — Attestation failed validations.
          - `failures` AttestationValidationFailure[], required — Information about the failed validations for this attestation.
            - `failureCode` 'INCORRECT_DOCUMENT' | 'POOR_QUALITY' | 'MISSING_INFORMATION' | 'INCONSISTENT_DATA' | 'EXPIRED_DOCUMENT' | 'OTHER', required — A reason the validation failed.
            - `severity` 'BLOCKING' | 'WARNING', required — `BLOCKING` must be addressed before submit can succeed; `WARNING` can be resolved by acknowledging warnings at submit-time.
          - `type` 'failed', required

## Other responses

- `401` — Unauthorized
- `403` — SignedAgreementRequiredException

---

[API](https://skmtc.net/muralpay/apis/mural-api.md) · [All operations](https://skmtc.net/muralpay/apis/mural-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/muralpay/mural-api/revisions/437d277f5948/schema)