---
title: "List authorities for a person"
method: GET
path: "/persons/{id}/authorities"
tags: ["customers"]
---

# List authorities for a person

`GET /persons/{id}/authorities`

List all authorities for a person by ID, optionally including revoked authorities.

## Path parameters

- `id` string, required — The ID of the person.

## Query parameters

- `include_revoked` boolean — Whether to include revoked authorities.

## Response `200`

OK

- CustomerAuthority[]
  - `authority_type` 'owner' | 'joint_owner' | 'signatory' | 'power_of_attorney' | 'trading', required
  - `created_at` string, date-time, required — The timestamp (in [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html) format) of when the resource was created.
  - `customer` union, required — Customer covered by the authority.
    - IndividualCustomer
      - `address` Address, required
        - `city` string, required — City or locality.
        - `country_code` string, required — ISO 3166-1 alpha-2 country code.
        - `district_county` string, nullable, required — District or county.
        - `line1` string, required — Primary street address line.
        - `line2` string, nullable, required — Additional street address line.
        - `line3` string, nullable, required — Further street address line.
        - `postal_code` string, required — Postal code.
      - `created_at` string, date-time, required — The timestamp (in [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html) format) of when the resource was created.
      - `customer_type` 'individual', required — Customer classification.
      - `date_of_birth` string, date-time, nullable, required — Customer's date and time of birth.
      - `first_name` string, required — Customer's first name.
      - `full_name` string, required — Customer's full display name.
      - `id` string, required — Unique resource identifier.
      - `id_number` string, nullable, required — Masked national identity number.
      - `last_name` string, required — Customer's last name.
      - `mifid_category` string, nullable, required — Customer's MiFID classification.
      - `modified_at` string, date-time, required — The timestamp (in [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html) format) of when the resource was last modified.
      - `nationalities` string[], nullable, required — ISO 3166-1 alpha-2 nationality codes.
      - `onboarding` string, nullable, required — ID of the customer's onboarding process.
      - `passport_number` string, nullable, required — Masked passport number.
      - `phone_number` string, nullable, required — Customer's primary phone number.
      - `reference` string, nullable, required — Customer-visible reference.
      - `referrer_code` string, nullable, required — Referral code associated with the customer.
      - `risk_profile` string, nullable, required — Customer's assigned risk profile.
      - `risk_score` string, nullable, required — Customer's risk score.
      - `status` 'active' | 'suspended' | 'closing' | 'closed', required
      - `tax_number` string, nullable, required — Masked tax identification number.
    - JointCustomer
      - `address` Address, required
        - `city` string, required — City or locality.
        - `country_code` string, required — ISO 3166-1 alpha-2 country code.
        - `district_county` string, nullable, required — District or county.
        - `line1` string, required — Primary street address line.
        - `line2` string, nullable, required — Additional street address line.
        - `line3` string, nullable, required — Further street address line.
        - `postal_code` string, required — Postal code.
      - `created_at` string, date-time, required — The timestamp (in [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html) format) of when the resource was created.
      - `customer_type` 'joint', required — Customer classification.
      - `first_name` string, nullable, required — Combined first names of the joint owners.
      - `full_name` string, required — Customer's full display name.
      - `id` string, required — Unique resource identifier.
      - `last_name` string, nullable, required — Combined last names of the joint owners.
      - `mifid_category` string, nullable, required — Customer's MiFID classification.
      - `modified_at` string, date-time, required — The timestamp (in [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html) format) of when the resource was last modified.
      - `onboarding` string, nullable, required — ID of the customer's onboarding process.
      - `phone_number` string, nullable, required — Customer's primary phone number.
      - `reference` string, nullable, required — Customer-visible reference.
      - `referrer_code` string, nullable, required — Referral code associated with the customer.
      - `risk_profile` string, nullable, required — Customer's assigned risk profile.
      - `risk_score` string, nullable, required — Customer's risk score.
      - `status` 'active' | 'suspended' | 'closing' | 'closed', required
    - BusinessCustomer
      - `address` Address, required
        - `city` string, required — City or locality.
        - `country_code` string, required — ISO 3166-1 alpha-2 country code.
        - `district_county` string, nullable, required — District or county.
        - `line1` string, required — Primary street address line.
        - `line2` string, nullable, required — Additional street address line.
        - `line3` string, nullable, required — Further street address line.
        - `postal_code` string, required — Postal code.
      - `created_at` string, date-time, required — The timestamp (in [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html) format) of when the resource was created.
      - `customer_type` 'business', required — Customer classification.
      - `entity_name` string, required — Registered business name.
      - `entity_type` string, nullable, required — Legal form of the business.
      - `full_name` string, required — Customer's full display name.
      - `id` string, required — Unique resource identifier.
      - `lei_code` string, nullable, required — Legal Entity Identifier.
      - `lei_code_expiry_date` string, date, nullable, required — Expiry date of the Legal Entity Identifier.
      - `mifid_category` string, nullable, required — Customer's MiFID classification.
      - `modified_at` string, date-time, required — The timestamp (in [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html) format) of when the resource was last modified.
      - `onboarding` string, nullable, required — ID of the customer's onboarding process.
      - `operating_address` Address, required
        - `city` string, required — City or locality.
        - `country_code` string, required — ISO 3166-1 alpha-2 country code.
        - `district_county` string, nullable, required — District or county.
        - `line1` string, required — Primary street address line.
        - `line2` string, nullable, required — Additional street address line.
        - `line3` string, nullable, required — Further street address line.
        - `postal_code` string, required — Postal code.
      - `phone_number` string, nullable, required — Customer's primary phone number.
      - `reference` string, nullable, required — Customer-visible reference.
      - `referrer_code` string, nullable, required — Referral code associated with the customer.
      - `risk_profile` string, nullable, required — Customer's assigned risk profile.
      - `risk_score` string, nullable, required — Customer's risk score.
      - `status` 'active' | 'suspended' | 'closing' | 'closed', required
  - `granted_at` string, date-time, required — Date and time the authority was granted.
  - `id` string, required — Unique resource identifier.
  - `modified_at` string, date-time, required — The timestamp (in [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html) format) of when the resource was last modified.
  - `person` union, required — Person granted the authority.
    - NaturalPerson
      - `address` Address, required
        - `city` string, required — City or locality.
        - `country_code` string, required — ISO 3166-1 alpha-2 country code.
        - `district_county` string, nullable, required — District or county.
        - `line1` string, required — Primary street address line.
        - `line2` string, nullable, required — Additional street address line.
        - `line3` string, nullable, required — Further street address line.
        - `postal_code` string, required — Postal code.
      - `created_at` string, date-time, required — The timestamp (in [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html) format) of when the resource was created.
      - `date_of_birth` string, date, nullable, required — Person's date of birth.
      - `first_name` string, nullable, required — Person's first name.
      - `full_name` string, required — Full name: first and last for natural persons, entity name for legal persons.
      - `id` string, required — Unique resource identifier.
      - `id_number` string, nullable, required — Masked national identity number.
      - `last_name` string, nullable, required — Person's last name.
      - `modified_at` string, date-time, required — The timestamp (in [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html) format) of when the resource was last modified.
      - `nationalities` string[], required — ISO 3166-1 alpha-2 nationality codes.
      - `passport_number` string, nullable, required — Masked passport number.
      - `person_type` 'natural', required — Person classification.
      - `phone_number` string, nullable, required — Person's primary phone number.
      - `tax_number` string, nullable, required — Masked tax identification number.
    - LegalPerson
      - `address` Address, required
        - `city` string, required — City or locality.
        - `country_code` string, required — ISO 3166-1 alpha-2 country code.
        - `district_county` string, nullable, required — District or county.
        - `line1` string, required — Primary street address line.
        - `line2` string, nullable, required — Additional street address line.
        - `line3` string, nullable, required — Further street address line.
        - `postal_code` string, required — Postal code.
      - `created_at` string, date-time, required — The timestamp (in [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html) format) of when the resource was created.
      - `entity_name` string, nullable, required — Registered legal entity name.
      - `entity_type` 'limited_company' | 'partnership' | 'sole_proprietorship' | 'foundation' | 'trust' | 'cooperative' | 'other', required
      - `full_name` string, required — Full name: first and last for natural persons, entity name for legal persons.
      - `id` string, required — Unique resource identifier.
      - `lei_code` string, nullable, required — Legal Entity Identifier.
      - `lei_code_expiry_date` string, date, nullable, required — Expiry date of the Legal Entity Identifier.
      - `modified_at` string, date-time, required — The timestamp (in [ISO-8601](https://www.iso.org/iso-8601-date-and-time-format.html) format) of when the resource was last modified.
      - `operating_address` Address, required
        - `city` string, required — City or locality.
        - `country_code` string, required — ISO 3166-1 alpha-2 country code.
        - `district_county` string, nullable, required — District or county.
        - `line1` string, required — Primary street address line.
        - `line2` string, nullable, required — Additional street address line.
        - `line3` string, nullable, required — Further street address line.
        - `postal_code` string, required — Postal code.
      - `person_type` 'legal', required — Person classification.
      - `phone_number` string, nullable, required — Person's primary phone number.
  - `revoked_at` string, date-time, nullable, required — Date and time the authority was revoked; `null` while the authority is still active.
  - `status` 'active' | 'revoked', required

## Other responses

- `400` — Bad Request

---

[API](https://skmtc.net/joinsophic/apis/sophic-engine-api.md) · [All operations](https://skmtc.net/joinsophic/apis/sophic-engine-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/joinsophic/sophic-engine-api/versions/250f4b477cbf/schema)