API Reference

Get merchants

To retrieve all merchants or search for merchants, call the /merchant/list endpoint.

📘
Search is optional

All merchants will be returned if you do not provide a search parameter.

Endpoint

GET https://development.knotapi.com/merchant/list?type=card_switcher&search=Walmart

Request fields

Field Name	Type	Description
type	required, string	The type of merchant to search for. This should be set to `card_switcher`.
search	string	The name of the merchant to search for.

Response example

If the search is successful, the endpoint will return a JSON object containing a list of matching merchants. The list will include the following information for each merchant:

Field Name	Type	Description
id	int	The unique ID of the merchant.
name	string	The name of the merchant.
logo	string	The logo displayed for the merchant.

[
  {
    "id": 44,
    "name": "Amazon",
    "logo": "https://storage.googleapis.com/knot-api/merchants/8pflGg1roAFAbdEl03zpl2dlYh54ZTmtq3yQ5NdO.png"
  },
  {
    "id": 19,
    "name": "DoorDash",
    "logo": "https://storage.googleapis.com/knot-api/merchants/E9gq4bxyuVTQipt5ek0xRZsMW4dO1K8pos9ZKLrd.png"
  },
  {
    "id": 41,
    "name": "Gopuff",
    "logo": "https://storage.googleapis.com/knot-api/merchants/IjcYPqgKO60f1WtE2z42T1db8EwoeyNKudplzRUT.png"
  }
]

Get connected merchants (Public)

To retrieve all merchants connected to the user, call the /merchant/connected?session={session_id} endpoint.

Endpoint

GET https://development.knotapi.com/merchant/connected?session_id=4f7d1df6-2841-4b51-9ed7-9c7e372885c4

Request fields

Field Name	Type	Description
session_id	required, string	Your Knot `session` ID.

curl -X GET 'https://development.knotapi.com/merchants/connected?session_id=4f7d1df6-2841-4b51-9ed7-9c7e372885c4'

Response example (1 connected merchant)

[
  {
    "id": 44,
    "name": "Amazon",
    "logo": "https://storage.googleapis.com/knot-api/merchants/8pflGg1roAFAbdEl03zpl2dlYh54ZTmtq3yQ5NdO.png",
    "status": "enrolled"
  }
]