v1

latestOpenAPI 3.1.02026-07-262218115.4 KB

Retrieve a list of available merchants.

post/merchant/list

Request body

type'card_switcher' | 'transaction_link' | 'shopping' | 'vault' | 'subscription_manager' required

Product for which the merchants are available.

platform'ios' | 'android' | 'web'

Platform for which the merchants are available.

searchstring

Name of a specific merchant.

external_user_idstring

Your unique identifier for the user. The values of the status parameter returned in the response when sending external_user_id can be found here.

Example request

{
  "type": "card_switcher",
  "platform": "ios"
}

Response

Successful request.

OR

Example response

[
  {
    "id": 10,
    "name": "Uber",
    "category": "Transportation",
    "logo": "https://knot.imgix.net/merchants/KBQ5j6cN010PPpwbO7RpKGyDrCpsZ91FRhwnZp5u.png",
    "popular": true,
    "min_sdk_version": "2.0.5"
  }
]