---
title: "List Accounts"
method: GET
path: "/identity/accounts"
tags: ["Accounts"]
---

# List Accounts

`GET /identity/accounts`

List accounts with pagination. Every response will contain a `next_page` field,
as long as the end of the list has not been reached. Pass this value into the `page_cursor` field of the next request
to retrieve the next page of results.

## Query parameters

- `page_cursor` string
- `order` 'DESC' | 'ASC'
- `order_by` 'CREATED_AT'
- `limit` integer
- `created_at.lt` string, date-time
- `created_at.lte` string, date-time
- `created_at.eq` string, date-time
- `created_at.gte` string, date-time
- `created_at.gt` string, date-time
- `identity_id` string
- `updated_at.lt` string, date-time
- `updated_at.lte` string, date-time
- `updated_at.eq` string, date-time
- `updated_at.gte` string, date-time
- `updated_at.gt` string, date-time

## Response `200`

A successful response.

- ListAccountsResponse
  - `next_page_cursor` string — Cursor token required for fetching the next page.
  - `items` Account[] — The result list of accounts.
    - `id` string — The id used for all other interactions with this account. Required on update. Auto-generated on create; do not set.
    - `identity_id` string — The primary identity associated with the account. Required on create. Not writable on update.
    - `description` string — A free-text description of the account.
    - `admin_disabled` boolean — true if the account has been disabled by a Paxos admin.
    - `user_disabled` boolean — true if the account has been disabled by the API user.
    - `metadata` object — API User-facing metadata.
    - `ref_id` string — A user-facing ID to prevent duplicate account creation. Unique for all accounts created by the same API user.
    - `members` AccountMember[] — Additional Identities with varying types of access to this account.
      - `identity_id` string, required
      - `type` 'BENEFICIAL_OWNER' | 'AUTHORIZED_USER' | 'FINANCIAL_ADVISOR'
      - `roles` AccountMemberAccountRoleType[]
      - `id` string — Account member ID. Note: This field is auto-generated. Specifying an ID when creating an account member is a client error.
    - `created_at` string, date-time — The time this account was created.
    - `summary_status` 'PENDING' | 'ERROR' | 'APPROVED' | 'DENIED' | 'DISABLED'
    - `updated_at` string, date-time — The time this account was updated.
    - `profile_id` string — The ID of the profile created for the account when `create_profile=true`. The [Profile](#tag/Profiles) type is `NORMAL`. The field is omitted when the account has no associated [Profile](#tag/Profiles).
    - `type` 'BROKERAGE' | 'TRADITIONAL_IRA' | 'ROTH_IRA' | 'SEP_IRA' | 'FINANCIAL_ADVISOR'

---

[API](https://skmtc.net/paxos/apis/paxos-api.md) · [All operations](https://skmtc.net/paxos/apis/paxos-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/paxos/paxos-api/revisions/0687ca8c9a8d/schema)