Retrieve a paginated list of all token holders associated with a specific token.

get

https://example.com/servicing/api/v2/servicing/tokens/{tokenId}/holders

This endpoint delivers a unified view of your token's holder and qualified investors by aggregating data across multiple sources, giving you complete visibility into your token's distribution and adoption.

Use this endpoint to:
- Monitor the composition of your investor base across the entire token ecosystem
- Analyze holder distributions for compliance and reporting requirements
- Maintain visibility of all entities with relationships to your token, not just current holders

Access level: Requires authentication with an agent or an owner account.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

tokenId

string

required

Query Params

limit

number

≤ 1000

Defaults to 20

Limit of results to return in one call

offset

number

Defaults to 0

Offset to return results from

sortBy

string

enum

Defaults to balance

sort results by attribute, default: balance

sortDirection

string

Defaults to DESC

set the direction (ASC or DESC) of sorted results by attribute, default: DESC

status

string

filter by holder statuses. One of [Qualified,Failed,InProgress,TokenHolder,Revoked]

string

filter by email field

firstName

string

filter by first name field

lastName

string

filter by last name field

institutionName

string

filter by institution name field

investor

string

filter by first and last name or institution legal name field

identityAddress

string

filter by OnchainID identity address field

countriesOfResidence

string

filter by countries of residence field

identityId

string

filter by identityId

wallet

string

wallet of the investor

typeOfInvestor

string

enum

filter by type of Investor institutional or individual

Allowed:

jwt

string

JWT access token

walletProvider

string

enum

Provider of the wallet address.

Allowed:

Responses

400

Token Holders retrieval failed due to invalid data.

401

Unauthorized.

403

Token not manageable with this authentication.

404

Token not found.

200Details of all token holder profile.