Merchants

Get matched merchants for a given merchant descriptor

Returns merchant details for matched merchants given a merchant descriptor as input. (IMPORTANT - Please remove all spaces from the merchant descriptor before submitting your API request)

get/merchants

Request

Base URL
https://api.mastercard.com/merchant-identifier
Auth
none declared
TypeScript
https://skmtc.dev/mastercard/apis/merchant-identifier-api/docs/merchants/get.ts
A function with typed inputs. Its response is checked against the schema.

Query parameters

merchant_descriptorstring required

The Merchant Descriptor being queried

match_typestring

The type of match to perform

Response

Information for this merchant identifier

Example response

{
  "merchants": [
    {
      "matchConfidenceScore": 100,
      "address": {
        "line1": "UNIT 2 248 WELSHPOOL RD",
        "line2": "12",
        "city": "Springfield",
        "postalCode": "6106",
        "country": {
          "code": "AUS",
          "name": "Australia"
        },
        "countrySubdivision": {
          "code": "WA",
          "name": "Western Australia"
        }
      },
      "brandName": "DOLIUM PTY LTD",
      "phoneNumber": "893582575",
      "merchantCategory": "5533 - AUTOMOTIVE PARTS  ACCESSORIES STORES",
      "merchantDbaName": "DOLIUM PTY LTD",
      "merchantDescriptor": "DOLIUMPTYLTDWELSHPOOLWA",
      "legalCorporateName": "DOLIUM PTY LTD",
      "locationId": 344147943,
      "isBrickAndMortar": true,
      "isEcommerce": true
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.