GET
/
detected_accounts
/
get
cURL
curl --request GET \
  --url https://development.knotapi.com/detected_accounts/get \
  --header 'Authorization: Basic <encoded-value>'
[
  {
    "merchant": {
      "id": 35,
      "name": "Spotify",
      "logo": "https://knot.imgix.net/merchants/KBQ5j6cN010PPpwbO7RpKGyDrCpsZ91FRhwnZp5u.png"
    },
    "name": "Spotify",
    "account_created_at": "2025-08-24T11:53:09Z",
    "detected_at": "2025-10-23T17:00:00Z"
  },
  {
    "merchant": {
      "id": 46,
      "name": "Netflix",
      "logo": "https://knot.imgix.net/merchants/KBQ5j6cN010PPp8aks0aGyDrCpsZ91FRhwnZp5u.png"
    },
    "name": "Netflix",
    "account_created_at": "2025-01-15T09:30:00Z",
    "detected_at": "2025-08-01T17:00:02Z"
  },
  {
    "name": "Magisto",
    "account_created_at": "2024-08-01T15:20:00Z",
    "detected_at": "2025-08-01T17:00:05Z"
  },
  {
    "name": "Foxwoods",
    "account_created_at": "2023-11-15T09:45:00Z",
    "detected_at": "2025-08-01T17:00:05Z"
  },
  {
    "name": "GasBuddy",
    "account_created_at": "2024-03-22T14:30:00Z",
    "detected_at": "2025-08-01T17:00:05Z"
  },
  {
    "name": "Chick-fil-A",
    "account_created_at": "2024-01-05T18:15:00Z",
    "detected_at": "2025-08-01T17:00:05Z"
  },
  {
    "name": "Indeed Jobs",
    "account_created_at": "2024-05-12T09:30:00Z",
    "detected_at": "2025-08-01T17:00:05Z"
  },
  {
    "name": "Copilot",
    "account_created_at": "2024-09-28T14:45:00Z",
    "detected_at": "2025-08-01T17:00:05Z"
  },
  {
    "name": "Sunoco",
    "account_created_at": "2024-03-15T11:20:00Z",
    "detected_at": "2025-08-01T17:00:05Z"
  },
  {
    "name": "VSCO",
    "account_created_at": "2024-07-01T16:05:00Z",
    "detected_at": "2025-08-01T17:00:05Z"
  },
  {
    "name": "Fetch",
    "account_created_at": "2024-02-18T13:40:00Z",
    "detected_at": "2025-08-01T17:00:05Z"
  }
]
This endpoint is coming soon. Check in with the Knot team to see when you can get access.

​
Overview

This endpoint allows you to retrieve an array of detected accounts for a given user. These are accounts that a user has, but are not yet linked to Knot. Knot automatically detects the existence of accounts with merchants as users interact with products like CardSwitcher.

​
Usage

Detected accounts retrieved from this endpoint can be used to closely personalize the merchants you present to users in your app or through lifecycle marketing campaigns. For example, if a detected account at Uber is present for a user, you can more prominently display Uber to that user in your app or as a push notification/email. Moreover, aggregated detected account information can be useful in designing a rewards program or other product features throughout your app.

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.

Query Parameters

​
external_user_id
string
required

Your unique identifier for the user.

​
merchant_id
integer

Unique identifier for the merchant. If provided, only a detected account for this merchant will be returned.

Response

Successful request. Returns an array of detected merchant accounts.

​
merchant
object

Merchant information on the Knot platform. This object is not returned if the merchant for the detected account is not yet supported by Knot.

​
name
string

Detected name of the merchant.

Example:

"Spotify, Inc."

​
account_created_at
string<date-time>

ISO timestamp when the account was created.

Example:

"2025-02-24T11:53:09Z"

​
detected_at
string<date-time>

ISO timestamp when the account was first detected.

Example:

"2025-08-01T17:00:00Z"