---
title: "Account Holders search"
method: POST
path: "/account-holders/action/search"
tags: ["AccountHolders"]
---

# Account Holders search

`POST /account-holders/action/search`

## Request

- Base URL: `https://sandbox.preprod.connect.xpansiv.com/app/api/v1`
- URL: `https://sandbox.preprod.connect.xpansiv.com/app/api/v1/account-holders/action/search`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/xpansiv/apis/xpansiv-connect-api/docs/account-holders/action/search/post.ts> (a function with typed inputs; its response is checked against the schema)

## Query parameters

- `page` integer
- `size` integer

## Request body

- object
  - `registryAccountId` string: ID of the account on the registry.
  - `registryAccountName` string
  - `program` string: Ref.Data.PROGRAM
  - `accountType` string: Account type description.
  - `active` boolean: True/False.
  - `generatorAccount` boolean: True/False.

## Response `200`

Account Holders search successfully executed

- object
  - `page` integer, required
  - `size` integer, required
  - `totalPages` integer, required
  - `totalElements` integer, required
  - `content` AccountHolder[]
    - `registryAccountId` string, required: ID of the account on the registry.
    - `registryAccountName` string, required: Name of the account on the registry.
    - `program` string, required: Ref.Data.PROGRAM
    - `accountType` string: Account type description.
    - `managerName` string: Name of the manager.
    - `active` boolean, required: True/False.
    - `generatorAccount` boolean: True/False.

## Other responses

- `400`: Bad request
- `401`: Not authorized error
- `500`: Internal server error

---

[API](https://skmtc.dev/xpansiv/apis/xpansiv-connect-api.md) - [All operations](https://skmtc.dev/xpansiv/apis/xpansiv-connect-api/llms.txt) - [OpenAPI document](https://skmtc.dev/xpansiv/apis/xpansiv-connect-api/revisions/01c1f2c4ec1e?raw)