---
title: "Get all holders of the selected account."
method: GET
path: "/v1/accounts/{accountId}/holders"
tags: ["Accounts"]
---

# Get all holders of the selected account.

`GET /v1/accounts/{accountId}/holders`

## Path parameters

- `accountId` string, required

## Headers

- `sessionId` string, uuid
- `authorizationId` string, uuid

## Response `200`

Request was fulfilled and account holders are listed.

- AccountHoldersResponse — Object with a list of holders and holder's type.
  - `accountId` string, nullable — The internal technical identifier of th account.
  - `holders` AccountHolder[], nullable — List of the persons or companies who have access to the selected account.
    - `name` string, nullable
  - `type` 'BUSINESS' | 'CORPORATE' | 'PERSONAL' | 'UNKNOWN' — Currently available accounts types.

## Other responses

- `204` — Indicates that the request was performed but no content is returned.
- `206` — Successful response, with a partial representation of a list of transactions.
- `400` — Error caused by invalid or missing data.
- `401` — Authentication failed due to missing or invalid credentials.
- `403` — Error caused by end user (PSU) not permitted access to the resource.
- `404` — Endpoint does not exist or URL is not constructed correctly.
- `429` — Error caused by exceeding unattended accesses to api due to calling to this api and account combination too many times in one day.
- `500` — Error caused by remote technical issues, this status code is used for unforeseen technical issues.
- `503` — Returned when service is unavailable due to scheduled reasons, such as maintenance.
- `504` — Returned when request has been timed out in the gateway.

---

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