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

200
application/json

Successful request. Returns an array of detected merchant accounts.

The response is of type object[].