Merchant Search

Get detailed merchant information (beta)

Search for merchants in Spade’s merchant database.

These merchants show up as counterparties and/or third parties in enrichment responses. Whether a merchant shows up as a counterparty or a third party within a given enrichment is based on the role it is playing in the transaction.

Note that merchant ids are relatively stable; however, they may change over time due to real-world changes (e.g. mergers and acquisitions) as well as general improvements to our merchant database which can cause a small percentage of these ids to shift over time.

This endpoint currently supports only a subset of Spade’s merchants (mostly larger, frequently transacted merchants), with more merchants being added over time.

To learn more about merchant search, please read the Merchant Search Guide.

GET

merchants

curl --request GET \
  --url https://east.sandbox.spade.com/merchants \
  --header 'X-Api-Key: <api-key>'

{
  "counterparties": [
    {
      "id": "704bbd58-fb12-4bdb-9aae-2786704ea92a",
      "name": "Amazon",
      "similarity": 67.5,
      "logo": "https://static.v2.spadeapi.com/logos/de33f8973bc934c5b368a5b27155db02/light.png",
      "website": "www.amazon.com",
      "affiliates": [
        {
          "id": "49fd51a1-5a19-3e5d-8d28-eb056ecf8939",
          "name": "Amazon Pay",
          "logo": "https://static.v2.spadeapi.com/logos/49fd51a15a193e5d8d28eb056ecf8939/light.png",
          "website": "pay.amazon.com"
        }
      ],
      "alternates": [
        {
          "id": "49fd51a1-5a19-3e5d-8d28-eb056ecf8939",
          "similarity": 85.2
        }
      ],
      "expectedMerchantCategoryCodes": [
        {
          "code": "5942",
          "description": "Book Stores"
        }
      ],
      "expectedSpadeCategories": [
        {
          "id": "011-010-000-000",
          "name": "Online Marketplace",
          "icon": "https://static.v2.spadeapi.com/categories/b4b0d249b40249acb7445027d4574fc5/light.png",
          "fullCategoryHierarchy": [
            {
              "id": "011-000-000-000",
              "name": "Retail",
              "icon": "https://static.v2.spadeapi.com/categories/ee4ee39fd5474d31ac42f9e606b9040a/light.png"
            },
            {
              "id": "011-010-000-000",
              "name": "Online Marketplace",
              "icon": "https://static.v2.spadeapi.com/categories/b4b0d249b40249acb7445027d4574fc5/light.png"
            }
          ]
        }
      ]
    }
  ],
  "thirdParties": [
    {
      "id": "49fd51a1-5a19-3e5d-8d28-eb056ecf8939",
      "name": "Amazon Pay",
      "type": "payment_processor",
      "similarity": 50,
      "logo": "https://static.v2.spadeapi.com/logos/49fd51a15a193e5d8d28eb056ecf8939/light.png",
      "website": "pay.amazon.com"
    }
  ]
}

Authorizations

X-Api-Key

string

header

required

Query Parameters

name

string

required

The name of the merchant you want to find

Response

200

application/json

Successful operation

The response is of type object.

Report fraud on a transaction Match a merchant

curl --request GET \
  --url https://east.sandbox.spade.com/merchants \
  --header 'X-Api-Key: <api-key>'

{
  "counterparties": [
    {
      "id": "704bbd58-fb12-4bdb-9aae-2786704ea92a",
      "name": "Amazon",
      "similarity": 67.5,
      "logo": "https://static.v2.spadeapi.com/logos/de33f8973bc934c5b368a5b27155db02/light.png",
      "website": "www.amazon.com",
      "affiliates": [
        {
          "id": "49fd51a1-5a19-3e5d-8d28-eb056ecf8939",
          "name": "Amazon Pay",
          "logo": "https://static.v2.spadeapi.com/logos/49fd51a15a193e5d8d28eb056ecf8939/light.png",
          "website": "pay.amazon.com"
        }
      ],
      "alternates": [
        {
          "id": "49fd51a1-5a19-3e5d-8d28-eb056ecf8939",
          "similarity": 85.2
        }
      ],
      "expectedMerchantCategoryCodes": [
        {
          "code": "5942",
          "description": "Book Stores"
        }
      ],
      "expectedSpadeCategories": [
        {
          "id": "011-010-000-000",
          "name": "Online Marketplace",
          "icon": "https://static.v2.spadeapi.com/categories/b4b0d249b40249acb7445027d4574fc5/light.png",
          "fullCategoryHierarchy": [
            {
              "id": "011-000-000-000",
              "name": "Retail",
              "icon": "https://static.v2.spadeapi.com/categories/ee4ee39fd5474d31ac42f9e606b9040a/light.png"
            },
            {
              "id": "011-010-000-000",
              "name": "Online Marketplace",
              "icon": "https://static.v2.spadeapi.com/categories/b4b0d249b40249acb7445027d4574fc5/light.png"
            }
          ]
        }
      ]
    }
  ],
  "thirdParties": [
    {
      "id": "49fd51a1-5a19-3e5d-8d28-eb056ecf8939",
      "name": "Amazon Pay",
      "type": "payment_processor",
      "similarity": 50,
      "logo": "https://static.v2.spadeapi.com/logos/49fd51a15a193e5d8d28eb056ecf8939/light.png",
      "website": "pay.amazon.com"
    }
  ]
}

Welcome

Enrichment Guides

Tooling Guides

Spade API

More

Get detailed merchant information (beta)

Authorizations

Query Parameters

Response