JOjoinsophic
customers

List authorities for a person

Changed on

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

get/persons/{id}/authorities

Request

  • Base URL
    https://api.engine.usesophic.com
  • Auth
    HTTP bearer

Path parameters

idstring required

The ID of the person.

Query parameters

include_revokedboolean

Whether to include revoked authorities.

Response

OK

authority_type'owner' | 'joint_owner' | 'signatory' | 'power_of_attorney' | 'trading' required
created_atstring date-time required

The timestamp (in ISO-8601 format) of when the resource was created.

granted_atstring date-time required

Date and time the authority was granted.

idstring required

Unique resource identifier.

modified_atstring date-time required

The timestamp (in ISO-8601 format) of when the resource was last modified.

revoked_atstring date-time nullable required

Date and time the authority was revoked; null while the authority is still active.

status'active' | 'revoked' required

Example response

[
  {
    "customer": {
      "date_of_birth": "1988-04-12T00:00:00Z",
      "risk_score": "42.50"
    },
    "granted_at": "2026-07-14T09:30:00Z",
    "person": {
      "date_of_birth": "1988-04-12"
    },
    "revoked_at": "2026-08-01T12:00:00Z"
  }
]

Changes

  • 6a63920239d8Revision changes
    • breaking

      added to the / response property oneOf list for the response status

    • breaking

      added to the / response property oneOf list for the response status

    • breaking

      the / response's property type changed from no type to string for status

    • breaking

      the / response's property type changed from no type to string for status

    • warning

      added the new active enum value to the / response property for the response status

    • warning

      added the new joint_owner enum value to the / response property for the response status

    • warning

      added the new owner enum value to the / response property for the response status

    • warning

      added the new power_of_attorney enum value to the / response property for the response status

    • warning

      added the new revoked enum value to the / response property for the response status

    • warning

      added the new signatory enum value to the / response property for the response status

    • warning

      added the new trading enum value to the / response property for the response status

    • info

      removed from the / response property allOf list for the response status

    • info

      removed from the / response property allOf list for the response status

    • info

      removed from the / response property anyOf list for the response status

    • info

      removed from the / response property anyOf list for the response status

    • info

      added discriminator to / response property for the response status

    • info

      added discriminator to / response property for the response status

  • aa43bab6253cRevision changes
    • breaking

      response property context/additionalProperties/ list-of-types was widened by adding types array to media type application/json of response 400