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

# List Accounts

`GET /accounts`

List a list of user accounts.

## Query parameters

- `size` integer
- `cursor` string
- `userId` string
- `startDate` string, date
- `endDate` string, date

## Response `200`

OK

- AccountListResponse
  - `code` 'OK' | 'CREATED' | 'INVALID_CREDENTIALS' | 'INVALID_PARAMETERS' | 'INVALID_TOKEN' | 'UNAUTHORIZED_ACCESS' | 'MISSING_RESOURCE' | 'REQUEST_LIMIT_EXCEEDED' | 'SERVER_ERROR' | 'UNSUPPORTED_METHOD' | 'SERVER_UNAVAILABLE' | 'TIME_LIMIT_EXCEEDED' — Request status code
  - `message` string — Message response to the request
  - `requestId` string — Unique ID that is added to the body of every response for easy traceability of the request in our logs.
  - `data` object
    - `nextCursor` string — The next cursor value that can be used in the following query.
    - `items` Account[]
      - `id` string, required — Unique ID of this object
      - `createdAt` string, date-time, required — Date and time
      - `providerId` string, required — ID of the data provider
      - `userId` string, required — User ID associated with this account
      - `connectionStatus` 'PENDING' | 'AWAITING_MFA' | 'ERROR' | 'CONNECTED' | 'DISCONNECTED', required — Account connection status
      - `monitorStatus` 'ACTIVE' | 'USER_ACTION_REQUIRED' | 'UNSUPPORTED' | 'CUSTOMER_DISABLED', required — Account CDS status
      - `monitor` object, required
        - `status` 'ACTIVE' | 'USER_ACTION_REQUIRED' | 'UNSUPPORTED' | 'CUSTOMER_DISABLED', required — Account CDS status
        - `updatedAt` string, date-time — Date and time
      - `connection` object, required
        - `status` 'PENDING' | 'AWAITING_MFA' | 'ERROR' | 'CONNECTED' | 'DISCONNECTED', required — Account connection status
        - `errorCode` 'ACCOUNT_DISABLED' | 'ACCOUNT_INACCESSIBLE' | 'ACCOUNT_INCOMPLETE' | 'ACCOUNT_LOCKED' | 'AUTH_REQUIRED' | 'EXPIRED_CREDENTIALS' | 'INVALID_ACCOUNT_TYPE' | 'INVALID_AUTH' | 'INVALID_CREDENTIALS' | 'INVALID_MFA' | 'MFA_TIMEOUT' | 'SERVICE_UNAVAILABLE' | 'SYSTEM_ERROR' | 'TOS_REQUIRED' | 'UNSUPPORTED_AUTH_TYPE' | 'UNSUPPORTED_MFA_METHOD' | 'null', nullable — Error code
        - `errorMessage` string, nullable — Error message
        - `updatedAt` string, date-time, required — Date and time

## Changes

- **2026-07-15** (v1) `3bcbeecafbab` — 10 info
  - removed the non-success response with the status `400`
  - removed the non-success response with the status `401`
  - removed the non-success response with the status `403`
  - removed the non-success response with the status `404`
  - …6 more

[Change history](https://skmtc.dev/smileapi/apis/smile-api/changes/accounts/get.md)

---

[API](https://skmtc.dev/smileapi/apis/smile-api.md) · [All operations](https://skmtc.dev/smileapi/apis/smile-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/smileapi/smile-api/revisions/a4930eb49f4d/schema)