> ## Documentation Index > Fetch the complete documentation index at: https://docs.vaults.fyi/llms.txt > Use this file to discover all available pages before exploring further. # List vault holders > Retrieves current holders for a specific vault with their balances (converted to LP token amounts for rebasing vaults) ## OpenAPI ````yaml https://api.vaults.fyi/alpha/documentation/json get /alpha/{network}/{vaultId}/holders openapi: 3.0.3 info: title: Vaults.fyi Alpha API version: 0.1.0 description: >- Alpha API endpoints for features in early access. These endpoints are not included in the main API documentation and may change without notice. servers: - url: https://api.vaults.fyi description: Vaults.fyi Alpha API security: [] tags: - name: Cross Chain - name: CCTP Bridge - name: SVM - name: Holders - name: Advanced Analytics - name: Historical Positions paths: /alpha/{network}/{vaultId}/holders: get: tags: - Holders summary: List vault holders description: >- Retrieves current holders for a specific vault with their balances (converted to LP token amounts for rebasing vaults) operationId: listVaultHolders parameters: - schema: type: integer minimum: 0 default: 0 in: query name: page required: false description: Page number (starting from 0) - schema: type: integer exclusiveMinimum: true minimum: 0 maximum: 1000 default: 100 in: query name: perPage required: false description: Number of items per page - schema: type: string enum: - mainnet - optimism - arbitrum - polygon - gnosis - base - unichain - swellchain - celo - worldchain - berachain - ink - bsc - hyperliquid - plasma - avalanche - katana - linea - mega-eth - monad - etherlink - eip155:1 - eip155:10 - eip155:42161 - eip155:137 - eip155:100 - eip155:8453 - eip155:130 - eip155:1923 - eip155:42220 - eip155:480 - eip155:80094 - eip155:57073 - eip155:56 - eip155:999 - eip155:9745 - eip155:43114 - eip155:747474 - eip155:59144 - eip155:4326 - eip155:143 - eip155:42793 in: path name: network required: true description: Include only vaults with provided network(name or CAIP) - schema: type: string in: path name: vaultId required: true description: Vault id of the vault for which the data will be returned responses: '200': description: Default Response content: application/json: schema: type: object properties: itemsOnPage: type: integer description: Number of items on the current page nextPage: type: integer description: Next page number data: type: array items: type: object properties: address: type: string pattern: ^0x[a-fA-F0-9]{40}$ description: Address of the holder balance: type: string description: Balance of the vault shares held by the holder required: - address - balance additionalProperties: false description: Array of items on the current page required: - itemsOnPage - data additionalProperties: false '400': description: Default Response content: application/json: schema: anyOf: - type: object properties: statusCode: type: number error: type: string enum: - Bad Request message: type: string errorId: type: string required: - statusCode - error - message additionalProperties: false - {} '401': description: Default Response content: application/json: schema: anyOf: - type: object properties: error: type: string enum: - Unauthorized message: type: string enum: - >- An API key is required to access this service. Sign up at https://portal.vaults.fyi/signup to generate a key. We offer a Pay-As-You-Go plan so you only pay for what you use, with no commitments. errorId: type: string required: - error - message additionalProperties: false - {} '402': description: Default Response content: application/json: schema: anyOf: - type: object properties: x402Version: anyOf: - type: number - type: string error: type: string resource: type: object properties: url: type: string description: type: string mimeType: type: string serviceName: type: string tags: type: array items: type: string iconUrl: type: string required: - url additionalProperties: false accepts: anyOf: - type: array items: type: object properties: scheme: type: string enum: - exact network: type: string amount: type: string payTo: type: string maxTimeoutSeconds: type: number asset: type: string extra: type: object properties: name: type: string version: type: string required: - name - version additionalProperties: false required: - scheme - network - amount - payTo - maxTimeoutSeconds - asset additionalProperties: false - {} extensions: type: object additionalProperties: {} required: - x402Version - resource additionalProperties: false - {} '403': description: Default Response content: application/json: schema: anyOf: - type: object properties: error: type: string enum: - Forbidden message: type: string enum: - >- This API key has exhausted its available credits. To resume service, please visit https://portal.vaults.fyi/signup to top-up your credits errorId: type: string required: - error - message additionalProperties: false - {} '404': description: Default Response content: application/json: schema: type: object properties: error: type: string enum: - Not Found message: type: string required: - error - message additionalProperties: false '408': description: Default Response content: application/json: schema: anyOf: - type: object properties: message: type: string errorId: type: string additionalProperties: false - {} '422': description: Default Response content: application/json: schema: anyOf: - type: object properties: statusCode: type: number error: type: string enum: - Unprocessable Entity message: type: string errorId: type: string required: - statusCode - error - message additionalProperties: false - {} '500': description: Default Response content: application/json: schema: anyOf: - type: object properties: error: type: string enum: - Internal Server Error message: type: string errorId: type: string required: - error - message additionalProperties: false - {} '503': description: Default Response content: application/json: schema: anyOf: - type: object properties: statusCode: type: number error: type: string enum: - Service Unavailable message: type: string errorId: type: string required: - statusCode - error - message additionalProperties: false - {} security: - apiKey: [] components: securitySchemes: apiKey: type: apiKey name: x-api-key in: header ````