---
title: "List account relationships"
method: GET
path: "/accounts/{account_id}/relationships"
tags: ["Accounts"]
---

# List account relationships

`GET /accounts/{account_id}/relationships`

List all customers of an account

## Path parameters

- `account_id` string, uuid, required

## Query parameters

- `page_token` string — Optional pagination token to be provided to retrieve subsequent pages, returned from previous get
- `limit` integer — Maximum number of objects to return per page. If the limit is greater than 100, then it will be set to 100.

## Response `200`

List of account relationships

- RelationshipList
  - `relationships` RelationshipResponse[], required — Array of relationships
    - `account_id` string, uuid — Account ID
    - `business_id` string, uuid — Business associated with the current account. One of business_id or customer_id must be specified.
    - `created_at` string, date-time — Date and time when this association was created.
    - `customer_id` string, uuid — Personal customer associated with the current account. One of customer_id or business_id must be specified.
    - `deleted_at` string, date-time — Date and time when this association was deleted.
    - `id` string, uuid — ID of account relationship
    - `ownership_percentage` number, double — The ownership percentage of the related party.
    - `person_id` string, uuid — Person associated with the current account. This attribute is deprecated and will be removed in a future API version. Use customer_id instead.
    - `relationship_type` 'ACCOUNT_HOLDER' | 'AUTHORIZED_SIGNER' | 'AUTHORIZED_USER' | 'BENEFICIARY' | 'JOINT_ACCOUNT_HOLDER' | 'PRIMARY_ACCOUNT_HOLDER', required — Relationship type
    - `updated_at` string, date-time — Date and time when this association was last updated.
  - `next_page_token` string — If returned, use the next_page_token to query for the next page of results. Not returned if there are no more rows.

## Other responses

- `401` — Unauthorized
- `404` — Resource not found
- `461` — Account has been closed

---

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