# Data Elements source: https://developer.mastercard.com/locations-merchants/documentation/tutorials-and-guides/data-elements/index.md ## Overview {#overview} The Mastercard Location Services API provides detailed information about various data fields related to merchant locations. Please refer to the [Location Services Response Fields](https://developer.mastercard.com/locations-merchants/documentation/tutorials-and-guides/data-elements/index.md#location-services-response-fields) table for a comprehensive understanding of the returned fields. ## Location Services Response Fields {#location-services-response-fields} This table lists all the fields available through the Location Services APIs. The fields below are part of the API output. Check the sample response at endpoint level on the [API Reference page](https://developer.mastercard.com/locations-merchants/documentation/api-reference/index.md). | Field Name | Field Parameter | Description | Example | |------------------------------------|------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------| | **Address Line 1** | `addressLine1` | Primary street address line of the merchant location (building number and street name). Sourced from acquirer-reported merchant fields and 3rd-party data. | `1 Oak Street` | | **Address Line 2** | `addressLine2` | Secondary address line (unit, suite, apt, floor) | `Apt 1` | | **City Name** | `city` | City or Town of Merchant's location | `OFallon` | | **Distance** | `distance` | Indicator showing distance from the input search parameter | `1.75723` | | **Distance Unit** | `distanceUnit` | Indicator showing the unit of the distance | `MILE` | | **Geo Coding Result** | `geocodingResult` | Indicator showing quality or precision of the geographic coordinates assigned to the Merchant's location. This reflects the accuracy of latitude and longitude for the Merchant's location | `S8HPNTSCZA` | | **Latitude** | `latitude` | Latitude of the Merchant's location | `38.670337` | | **Longitude** | `longitude` | Longitude of the Merchant's location | `-90.443727` | | **Country Code** | `countryCode` | Three-letter ISO country code of Merchant's location | `USA` | | **Country Name** | `countryName` | Country name of Merchant's location | `United States` | | **State Province Code** | `countrySubdivisionCode` | State or Province code of Merchant's location | `MO` | | **State Province Name** | `countrySubdivisionName` | State or Province name of Merchant's location | `Missouri` | | **Postal Code** | `postalCode` | Zip/postal code of Merchant's location | `63366` | | **Location Name** | `locationName` | Name of Merchant's location | `QUIK TRIP STORE 1` | | **Merchant Name Searched** | `searchedMerchantName` | Merchant name parameter used in the request. | `Pizza` | | **Merchant Name** | `merchantNames` | Merchant brand or trade name (for search results filtered by name) | `Planet Pizza` | | **Merchant Phone Number** | `phoneNumber` | Merchant contact phone number. | `8165442210` | | **Merchant Type** | `merchantType` | Type of merchant location- 'paypass' 'easysavings' and 'cashback'. | `PAYPASS` | | **Category Id** | `category` | Category Id of the merchant location. See the Categories resource for a list of valid categories. | `10 - Grocery Stores & Supermarkets` | | **Unique Identifier** | `id` | Unique record identifier for the API response entry. | `1505451132` | | **Merchant Website URL** | `websiteUrl` | Primary website URL of the merchant. | `www.mcdonalds.com` | | **Maximum Cashback Amount** | `cashbackMaximumAmount` | Maximum cashback amount available at this merchant location (in local currency units) | `40` | | **Easy Savings Merchant Offer Id** | `easySavingsMerchantOfferId` | Unique identifier for a Mastercard Easy Savings offer associated with the merchant location. | `1143109` | | **Paypass Concession** | `isPayPassConcession` | Indicates PayPass accepted at a concession stand (stadium, venue, etc.). | `true/false` | | **Paypass Pharmacy** | `isPayPassPharmacy` | Indicates PayPass accepted at a pharmacy checkout. | `true/false` | | **Paypass Fuel Pump** | `isPayPassFuelPump` | Indicates PayPass accepted at a fuel dispenser or pay-at-the-pump. | `true/false` | | **Paypass Toll Booth** | `isPayPassTollBooth` | Indicates PayPass accepted at a toll booth. | `true/false` | | **Paypass Drive Through** | `isPayPassDriveThrough` | Indicates PayPass accepted at a drive-through lane. | `true/false` | | **Paypass Register** | `isPayPassRegister` | Indicates PayPass accepted at a standard POS register. | `true/false` | | **Paypass Ticketing** | `isPayPassTicketing` | Indicates PayPass accepted at ticketing kiosks/counters. | `true/false` | | **Paypass Vending Machine** | `isPayPassVendingMachine` | Indicates PayPass accepted at a vending machine. | `true/false` | | **MMHID** | `locationId` | Unique Mastercard-defined ID for a merchant. Each distinct ID corresponds to a single merchant store. This ID is used to link merchants across all Mastercard products and services | `300945305` |