---
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`

## Request

- Base URL: `https://oas.finshark.io/api.finshark.io`
- URL: `https://oas.finshark.io/api.finshark.io/v1/accounts/{accountId}/holders`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/finshark/apis/finshark-api/docs/v1/accounts/:accountId/holders/get.ts> (a function with typed inputs; its response is checked against the schema)

## 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.dev/finshark/apis/finshark-api.md) - [All operations](https://skmtc.dev/finshark/apis/finshark-api/llms.txt) - [OpenAPI document](https://skmtc.dev/finshark/apis/finshark-api/revisions/7fc3b4f800ae?raw)