Welcome
- Introduction
- Understanding enriched data
- Integrating
Enrichment Guides
- Overview
- Enhanced data fields
- Batch enrichment guide
Tooling Guides
- Merchant matching
- Merchant search guide
- Category personalization guide
Spade API
- Card Enrichment
- Transfer Enrichment
- Feedback and Reporting
- Merchant Search
- Merchant Matching
- Category Personalization
More
- User experience
- Understanding match scores
- Glossary
- FAQ
Merchant Matching
Match a merchant
Match a merchant to a Spade Counterparty and Location.
POST
/
merchants
/
match
Copy
Ask AI
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"
}
}'
Copy
Ask AI
{
"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
Body
application/json
Response
200
application/json
Successful operation
The response is of type object
.
Copy
Ask AI
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"
}
}'
Copy
Ask AI
{
"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"
}
}
Assistant
Responses are generated using AI and may contain mistakes.