Skip to main content
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"
    },
    "login_method": "GOOGLE_SSO",
    "account_created_at": "2025-08-24T11:53:09Z",
    "detected_at": "2025-10-23T17:00:00Z"
  },
  {
    "merchant": {
      "id": 44,
      "name": "Walmart",
      "logo": "https://knot.imgix.net/merchants/walmart.png"
    },
    "login_method": "",
    "account_created_at": "",
    "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. Call this endpoint upon receiving the NEW_DETECTED_ACCOUNTS_AVAILABLE webhook.

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

Merchant information on the Knot platform.

​
detected_at
string<date-time>
required

ISO timestamp when the account was first detected.

Example:

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

​
login_method
enum<string>

The method used to log into the merchant account.

Available options:
GOOGLE_SSO,
APPLE_SSO,
AMAZON_SSO,
USERNAME_PASSWORD
Example:

"GOOGLE_SSO"

​
account_created_at
string<date-time>

ISO timestamp when the account was created.

Example:

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