Skip to main content
POST
/
detected-accounts
/
list
cURL
curl --request POST \
  --url https://development.knotapi.com/detected-accounts/list \
  --header 'Authorization: Basic <encoded-value>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "external_user_id": "abc",
  "cursor": "eyJpZCI6MjI3ODEsIl9wb2ludHNUb05leHRJdGVtcyI6dHJ1ZX0",
  "limit": 100
}
'
{
  "detected_accounts": [
    {
      "merchant": {
        "id": 35,
        "name": "Spotify",
        "logo": "https://knot.imgix.net/merchants/KBQ5j6cN010PPpwbO7RpKGyDrCpsZ91FRhwnZp5u.png"
      },
      "detected_at": "2025-10-23T17:00:00Z"
    },
    {
      "merchant": {
        "id": 44,
        "name": "Walmart",
        "logo": "https://knot.imgix.net/merchants/walmart.png"
      },
      "detected_at": "2025-08-01T17:00:05Z"
    },
    {
      "merchant": {
        "id": 84,
        "name": "Chewy",
        "logo": "https://knot.imgix.net/merchants/chewy.png"
      },
      "detected_at": "2025-09-12T14:22:18Z"
    },
    {
      "merchant": {
        "id": 71,
        "name": "Verizon",
        "logo": "https://knot.imgix.net/merchants/verizon.png"
      },
      "detected_at": "2025-07-05T09:14:33Z"
    },
    {
      "merchant": {
        "id": 53,
        "name": "Airbnb",
        "logo": "https://knot.imgix.net/merchants/airbnb.png"
      },
      "detected_at": "2025-11-02T20:48:02Z"
    }
  ],
  "next_cursor": "eyJpZCI6MjI3ODEsIl9wb2ludHNUb05leHRJdGVtcyI6dHJ1ZX0",
  "limit": 100
}

​
Overview

This endpoint allows you to list detected accounts for a given user using cursor-based pagination. Primarily, these detected accounts are delivered in the NEW_DETECTED_ACCOUNTS_AVAILABLE webhook payload.

Authorizations

​
Authorization
string
header
required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password. Use your client_id as the username and your secret as the password value.

Body

application/json

The input parameters required for listing detected accounts.

​
external_user_id
string
required

Your unique identifier for the user.

Example:

"abc"

​
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.

Example:

"eyJpZCI6MjI3ODEsIl9wb2ludHNUb05leHRJdGVtcyI6dHJ1ZX0"

​
limit
integer
default:100

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

Example:

100

Response

Successful request.

​
detected_accounts
object[]
​
next_cursor
string | null

Cursor token for the next page of detected accounts.

​
limit
integer

Number of detected accounts returned based on the limit provided.

Example:

100