Merchant
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"
}
]
Updated 10 days ago