POST
/
merchants
/
match
Match a merchant
curl --request POST \
  --url https://east.sandbox.spade.com/merchants/match \
  --header 'Content-Type: application/json' \
  --header 'X-Api-Key: <api-key>' \
  --data '{
  "requestId": "request_id_123456789",
  "merchantName": "Amazon",
  "address": "123 Main St",
  "city": "New York",
  "region": "NY",
  "country": "USA",
  "postalCode": "10001",
  "latitude": 37.774929,
  "longitude": -90.412702,
  "website": "https://www.amazon.com",
  "customAttributes": {
    "custom_attribute_1": "value_1",
    "custom_attribute_2": "value_2"
  }
}'
{
  "requestId": "<string>",
  "counterparty": {
    "id": "<string>",
    "name": "<string>",
    "similarity": 80
  },
  "location": {
    "id": "<string>",
    "name": "<string>",
    "address": "1234 W 5th Ave Suite 100",
    "city": "New York",
    "similarity": 80
  },
  "customAttributes": {
    "custom_attribute_1": "value_1",
    "custom_attribute_2": "value_2"
  }
}

Authorizations

​
X-Api-Key
string
header
required

Body

application/json
​
merchantName
string
required

Name of the merchant.

Examples:

"Amazon"

​
address
string
required

Street address of the merchant.

Examples:

"123 Main St"

​
city
string
required

City where the merchant is located.

Examples:

"New York"

​
region
string
required

Region or state where the merchant is located.

Examples:

"NY"

​
country
string
required

Country where the merchant is located.

Examples:

"USA"

​
postalCode
string
required

Postal code of the merchant's location.

Examples:

"10001"

​
requestId
string

Your ID for this request. Optional.

Examples:

"request_id_123456789"

​
latitude
number

Latitude of the merchant's location.

Examples:

37.774929

​
longitude
number

Longitude of the merchant's location.

Examples:

-90.412702

​
website
string<url>

Website of the merchant.

Examples:

"https://www.amazon.com"

​
customAttributes
object

A dictionary containing custom attributes that you would like to be returned in the response. Please ensure this object does not contain any PII. Restrictions include: customAttributes must be an object, up 30 custom attributes are allowed, each key must be a string <= 40 characters in length, and each value must be a string <= 250 characters in length.

Examples:
{
  "custom_attribute_1": "value_1",
  "custom_attribute_2": "value_2"
}

Response

Successful operation

​
requestId
string

Your ID for this request. null if not provided in the request.

​
counterparty
object
​
location
object
​
customAttributes
object

A dictionary containing the custom attributes that were included in the enrichment request (if any).

Examples:
{
  "custom_attribute_1": "value_1",
  "custom_attribute_2": "value_2"
}