Enrich multiple transactions - POST
Searches for an array of merchants. This endpoint is typically used for transaction list views. You send in multiple transactions at once in a single request.
2xPossible values: truefalsetrueAn optional array of response fields that will be force returned from our internal sources. This is useful if you want to cache fields such as the name or website during an extended call. Allowed values are: name, website, img, category, categories
["name","website"]A JSON object containing one property per transaction enriched.
The keys of this object are the ID that was provided, previously passed in as the "id" property in each transaction array element.
The value of this property is the array of merchants that were found when searching for that specific transaction
Returned when the request is malformed. Double check that you are sending the correct parameters in the request, and that they are valid. This error is also thrown when a trial account has expired or exceeded its usage limits.
Returned when the API key is invalid. Double check that you are sending the correct API key in the X-Api-Key header.
Returned when the API key is missing. Double check that you are sending the API key in the X-Api-Key header.
Returned when the endpoint is not found. Double check that you are sending the request to the correct endpoint.
Returned when the request has failed due to an internal server error. Please retry the request later.
POST /api/v3/merchant/list HTTP/1.1
Host: europe-west2.snowdrop-mrs.com
X-Api-Key: YOUR_API_KEY
Content-Type: application/json
Accept: */*
Content-Length: 362
{
"type": "extended",
"logo_size": "2x",
"defaultLogo": true,
"language": "text",
"additionalInfo": false,
"clearResponse": true,
"forceCacheableFields": [
"name",
"website"
],
"transactions": [
{
"id": "text",
"merchant_name": "text",
"location": "text",
"address": "text",
"city": "text",
"country": "text",
"postcode": "text",
"mcc": "text",
"online": true,
"latitude": 1,
"longitude": 1,
"radius": 1
}
]
}{
"id": [
{
"name": "text",
"website": "text",
"position": {
"type": "Point",
"coordinates": [
1
]
},
"img": "text",
"logoImg": "text",
"categoryImg": "text",
"logoScore": 1,
"address": "text",
"postal_code": "text",
"street_number": "text",
"route": "text",
"locality": "text",
"administrative_area_level_1": "text",
"administrative_area_level_2": "text",
"country": "text",
"phone": "text",
"rating": 4.1,
"reviews": {
"author_name": "A Google User",
"author_url": "text",
"profile_photo_url": "text",
"language": "text",
"original_language": "text",
"rating": 1,
"relative_time_description": "text",
"text": "text",
"time": 1,
"translated": true
},
"opening_hours": {
"open_now": true,
"periods": [
{
"open": {
"date": "text",
"day": 1,
"time": 1700,
"truncated": true
},
"close": {
"date": "text",
"day": 1,
"time": 1700,
"truncated": true
}
}
],
"special_days": [
{
"date": "text",
"exceptional_hours": true
}
],
"type": "text",
"weekday_text": [
"Monday: 9:00 AM – 5:00 PM",
"Tuesday: 9:00 AM – 5:00 PM",
"Wednesday: 9:00 AM – 5:00 PM",
"Thursday: 9:00 AM – 5:00 PM",
"Friday: 9:00 AM – 5:00 PM",
"Saturday: Closed",
"Sunday: Closed"
]
},
"price_level": 1,
"place_id": "ChIJN1t_tDeuEmsRUsoyG83frY4",
"category": "text",
"categories": [
"text"
],
"intermediary": {
"name": "Paypal",
"website": "https://www.paypal.com",
"img": "https://storage.googleapis.com/production-mrs-tm-logos/6273e53abb09494554c93872_2x.png"
},
"isClearResponse": false,
"cachePolicy": {
"name": "Google",
"website": "Google",
"position": "Google",
"img": "Google",
"logoImg": "Google",
"categoryImg": "Google",
"logoScore": "Google",
"address": "Google",
"postal_code": "Google",
"street_number": "Google",
"route": "Google",
"administrative_area_level_1": "Google",
"administrative_area_level_2": "Google",
"country": "Google",
"phone": "Google",
"opening_hours": "Google",
"place_id": "Google",
"category": "Google",
"categories": "Google",
"isClearResponse": "MRS"
},
"brand": {
"id": "64b70cd0584b4b1e7ebcf35d",
"name": "Carrefour Express",
"img": "https://storage.googleapis.com/production-mrs-brand-logos/6273e357bb09494554c92a5a_2x.png",
"website": "http://www.carrefour.com/",
"esg": {
"participations": []
},
"brandCategory": {
"parentCategory": "Retail & Shopping",
"categoryGroup": "Retail & Department Stores",
"categoryType": "Furniture"
},
"verifiedInputDate": "2024-09-02T08:46:35.785Z"
},
"aggregateLevel": {
"id": "64b70cd0584b4b1e7ebcf36d",
"name": "Carrefour",
"img": "https://storage.googleapis.com/production-mrs-tm-logos/6273e58dbb09494554c93ae3_2x.png",
"website": "https://www.carrefour.com/"
},
"store": {
"id": "66c78aa32cea1a4463b8c634"
}
}
]
}Last updated
Was this helpful?