Enrich one transaction - GET

Find a merchant based on raw transaction data

Start with our guide on how to use MRS to enrich raw transaction data. Note - See the clearResponse property below for options on how MRS should respond when a merchant was not found. If clearResponse is explicitly set to false and a merchant is not found, an empty array will be returned.

GEThttps://europe-west2.snowdrop-mrs.com/api/v3/merchant

Authorization

HeaderApiKeyAuth

Query parameters

Response

200400401403404500

A JSON array of merchant results

Headers

Body

application/json

itemsone of

objectobject

Request

JavaScriptCurlPythonHTTP

const response = await fetch('https://europe-west2.snowdrop-mrs.com/api/v3/merchant?type=restrictive&merchant_name=text', {
    method: 'GET',
    headers: {
      "X-Api-Key": "HeaderApiKeyAuth <apiKey>"
    },
});
const data = await response.json();

Response

200400401403404500

[
  {
    "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"
    }
  }
]