Sign in

v1

latestOpenAPI 3.1.02026-07-262218115.4 KB

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

post/detected-accounts/list

Request body

external_user_idstring required

Your unique identifier for the user.

cursorstring

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.

limitinteger

Maximum number of detected accounts to retrieve (min: 1, max: 100).

Example request

{
  "external_user_id": "abc",
  "cursor": "eyJpZCI6MjI3ODEsIl9wb2ludHNUb05leHRJdGVtcyI6dHJ1ZX0",
  "limit": 100
}

Response

Successful request.

next_cursorstring nullable

Cursor token for the next page of detected accounts.

limitinteger

Number of detected accounts returned based on the limit provided.

Example response

{
  "detected_accounts": [
    {
      "merchant": {
        "id": 122,
        "name": "Spotify",
        "logo": "https://knot.imgix.net/merchants/KBQ5j6cN010PPpwbO7RpKGyDrCpsZ91FRhwnZp5u.png"
      },
      "detected_at": "2025-08-01T17:00:00Z"
    }
  ],
  "limit": 100
}