---
title: "POST /detected-accounts/list"
method: POST
path: "/detected-accounts/list"
---

# POST /detected-accounts/list

`POST /detected-accounts/list`

List a user's detected accounts using cursor-based pagination.

## Request body

- object
  - `external_user_id` string, required — Your unique identifier for the user.
  - `cursor` string — Cursor token pointing to the last detected account retrieved. The `/detected-accounts/list` endpoint uses **cursor-based** pagination to track which detected accounts have already been seen, minimizing data redundancy. On the first call, the endpoint returns all detected accounts **paginated**. In subsequent calls, only new detected accounts are provided using the **next cursor**.
  - `limit` integer — Maximum number of detected accounts to retrieve (min: 1, max: 100).

## Response `200`

Successful request.

- object
  - `detected_accounts` object[]
    - `merchant` object — Merchant information on the Knot platform.
      - `id` integer — Static unique ID of the merchant (across all environments). This ID remains constant and does not change.
      - `name` string — Name of the merchant.
      - `logo` string — Logo of the merchant.
    - `detected_at` string, date-time — ISO timestamp when the account was first detected.
  - `next_cursor` string, nullable — Cursor token for the next page of detected accounts.
  - `limit` integer — Number of detected accounts returned based on the limit provided.

## Other responses

- `400` — Bad request.
- `401` — Unauthorized request.
- `403` — Forbidden request.
- `500` — Internal server error.

---

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