Skip to main content
GET
/
accounts
/
get
cURL
curl --request GET \
  --url https://development.knotapi.com/accounts/get \
  --header 'Authorization: Basic <encoded-value>'
[ { "merchant": { "id": 19, "name": "DoorDash", "logo": "https://knot.imgix.net/merchants/KBQ5j6cN010PPpwbO7RpKGyDrCpsZ91FRhwnZp5u.png" }, "connection": { "status": "connected", "scopes": [ { "type": "update_card" } ] }, "lifecycle": { "status": null }, "last_user_action": { "attempted_at": null, "status": null } }, { "merchant": { "id": 40, "name": "Instacart", "logo": "https://knot.imgix.net/merchants/KBQ5j6cN010PPpwbO7RpKGyDrCpsZ91FRhwnZp5u.png" }, "connection": { "status": "connected", "scopes": [ { "type": "update_card" } ] }, "lifecycle": { "status": null }, "last_user_action": { "attempted_at": null, "status": null } }, { "merchant": { "id": 12, "name": "Target", "logo": "https://knot.imgix.net/merchants/KBQ5j6cN010PPpwbO7RpKGyDrCpsZ91FRhwnZp5u.png" }, "connection": { "status": "disconnected", "scopes": [] }, "lifecycle": { "status": null }, "last_user_action": { "attempted_at": null, "status": null } } ]

Documentation Index

Fetch the complete documentation index at: https://docs.knotapi.com/llms.txt

Use this file to discover all available pages before exploring further.

This endpoint allows you to retrieve an array of merchant accounts for a given user (specified in the request with external_user_id) that are currently linked to Knot. If a user unlinked a merchant account with Unlink Merchant Account, it will not be returned. You can choose to retrieve all merchant accounts for a user or a single merchant account by passing a specific merchant_id in the request.

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 a merchant. Used to return a single merchant account object.

Example:

19

​
type
enum<string>

Product type for which you want to get the status of the most recent login attempt in lifecycle.status.

Available options:
card_switcher,
transaction_link,
vault
Example:

"card_switcher"

Response

Successful request. If you pass a merchant_id in the request, the response will be a single object, instead of an array.

​
merchant
object
​
connection
object
​
lifecycle
object
​
last_user_action
object