> ## Documentation Index > Fetch the complete documentation index at: https://docs.bastion.com/llms.txt > Use this file to discover all available pages before exploring further. # List Accounts > List Accounts belonging to your organization ## OpenAPI ````yaml /v2/openapi.yaml get /v2/accounts openapi: 3.1.0 info: title: Bastion APIs version: '2.0' servers: - url: https://api.prod.bastion.com description: Production environment - url: https://api.sandbox.bastion.io description: Sandbox environment security: - auth: [] tags: - name: Bastion APIs paths: /v2/accounts: get: tags: - Accounts summary: List Accounts description: List Accounts belonging to your organization operationId: bastion.api.v2.API.ListAccounts parameters: - name: limit in: query description: >- (OPTIONAL) The maximum number of accounts to return in a single page. required: false schema: type: integer title: limit maximum: 100 minimum: 1 format: int64 default: '50' - name: cursor in: query description: >- (OPTIONAL) Pagination cursor to be used in subsequent queries to retrieve next page of results. required: false schema: type: string title: cursor - name: identity_ids in: query description: |- (OPTIONAL) Optional identity IDs to filter accounts by. If provided, only accounts belonging to these identities will be returned. Maximum 25 identity IDs can be provided. required: false schema: type: array items: type: string description: '(OPTIONAL) ' title: identity_ids responses: '200': description: Success content: application/json: schema: $ref: '#/components/schemas/bastion.api.v2.ListAccountsResponse' '400': description: Bad request '401': description: Unauthorized Request '404': description: Resource not found '500': description: Internal Server Error components: schemas: bastion.api.v2.ListAccountsResponse: type: object properties: accounts: type: array items: $ref: '#/components/schemas/bastion.api.v2.Account' title: accounts description: The accounts requested cursor: type: string title: cursor description: >- Pagination cursor to be used in subsequent queries to retrieve next page of results. title: ListAccountsResponse additionalProperties: false bastion.api.v2.Account: type: object properties: request_id: type: string title: request_id description: Request identifier in a UUID format. Serves as an idempotency key identity_type: $ref: '#/components/schemas/bastion.common.IdentityType' title: identity_type addresses: type: array items: $ref: '#/components/schemas/bastion.api.WalletAddress' title: addresses readOnly: true identity_id: type: string title: identity_id description: Unique identifier of the identity associated with the account. readOnly: true id: type: string title: id description: Unique identifier of the account. readOnly: true account_type: $ref: '#/components/schemas/bastion.common.AccountType' title: account_type description: 'Deprecated: use "type" instead' readOnly: true deprecated: true frozen: type: boolean title: frozen description: |- True if the account is frozen. Accounts that are frozen are blocked from interacting with the Bastion platform without manual intervention. Contact compliance@bastion.com for more details if an account is frozen. readOnly: true identity_status: $ref: '#/components/schemas/bastion.api.IdentityStatus' title: identity_status description: The identity's top-level status. readOnly: true identity_sub_status: $ref: '#/components/schemas/bastion.api.IdentitySubStatus' title: identity_sub_status description: >- The identity's sub-status. Only meaningful when identity_status is PENDING_ONBOARDING. readOnly: true account_status: $ref: '#/components/schemas/bastion.api.account.AccountStatus' title: account_status description: 'Deprecated: use "status" instead' readOnly: true deprecated: true status: $ref: '#/components/schemas/bastion.api.account.AccountStatus' title: status description: The account's status, derived from its parent identity state. readOnly: true type: $ref: '#/components/schemas/bastion.common.AccountType' title: type description: |- The account's type. Valid values are OMNIBUS and SEGREGATED. LEDGER and ONCHAIN are legacy values. readOnly: true title: Account required: - request_id additionalProperties: false bastion.common.IdentityType: type: string title: IdentityType enum: - IDENTITY_TYPE_UNSPECIFIED - INDIVIDUAL - BUSINESS description: >- Identity type Please note that BUSINESS accounts are only supported in the US at this time. example: INDIVIDUAL bastion.api.WalletAddress: type: object properties: chains: type: array items: $ref: '#/components/schemas/bastion.common.Chain' title: chains address: type: string title: address title: WalletAddress additionalProperties: false bastion.common.AccountType: type: string title: AccountType enum: - ACCOUNT_TYPE_UNSPECIFIED - LEDGER - ONCHAIN - OMNIBUS - SEGREGATED example: LEDGER bastion.api.IdentityStatus: type: string title: IdentityStatus enum: - IDENTITY_STATUS_UNSPECIFIED - PENDING_ONBOARDING - ACTIVE - SUSPENDED - REJECTED - TERMINATED description: Top-level identity lifecycle status. example: PENDING_ONBOARDING bastion.api.IdentitySubStatus: type: string title: IdentitySubStatus enum: - IDENTITY_SUB_STATUS_UNSPECIFIED - CREATED - COMPLIANCE_CHECKS_IN_PROGRESS - IDV_REQUIRED - IDV_REQUESTED - IDV_IN_PROGRESS - IDV_EXPIRED - RFI_REQUIRED description: >- Sub-status within PENDING_ONBOARDING tracking onboarding workflow progress. Only meaningful when IdentityStatus is PENDING_ONBOARDING. example: CREATED bastion.api.account.AccountStatus: type: string title: AccountStatus enum: - ACCOUNT_STATUS_UNSPECIFIED - ACTIVE - FROZEN - CLOSED description: >- AccountStatus represents the state of an account, derived from its parent identity state. example: ACTIVE bastion.common.Chain: type: string title: Chain enum: - CHAIN_UNSPECIFIED - ETHEREUM_MAINNET - POLYGON_MAINNET - ETHEREUM_TESTNET - OPTIMISM_SEPOLIA - BASE_MAINNET - BASE_SEPOLIA - OPTIMISM_MAINNET - POLYGON_AMOY - SOLANA_MAINNET - SOLANA_DEVNET description: Chain identifier example: ETHEREUM_MAINNET securitySchemes: auth: type: http description: Bearer authentication with an API token scheme: bearer ```` ## Related topics - [Product updates](/changelog.md) - [List Virtual Accounts](/v2/api-reference/virtual-accounts/list-virtual-accounts.md) - [List Bank Accounts](/v2/api-reference/issuance/list-bank-accounts.md) - [List Identities](/v2/api-reference/identities/list-identities.md) - [List Mint Instructions](/v2/api-reference/issuance/list-mint-instructions.md)