Locations API API

by mastercard.com

Overview

The Locations API provides access to MasterCard's ATM and Merchant location database

Locations API is a geocoding API from mastercard.com. It needs no API key. It is served over HTTPS. Its OpenAPI description documents 7 endpoints.

At a glance

Authentication: No auth
HTTPS: Yes
CORS: Unknown
Category: Geocoding
Base URL: https://api.mastercard.com
Version: 1.0.0
Endpoints: 7
OpenAPI: Specification ↗
Spec updated: 2020-08-24

Make a first request

Replace the placeholders; the documentation says exactly where credentials go.

cURL

curl -X GET "https://api.mastercard.com/atms/v1/atm" \
  -H "Accept: application/json"

JavaScript

const response = await fetch("https://api.mastercard.com/atms/v1/atm", {
  method: "GET",
  headers: {
    "Accept": "application/json",
  },
});
const data = await response.json();
console.log(data);

Python

import requests

response = requests.request(
    "GET",
    "https://api.mastercard.com/atms/v1/atm",
    headers={
    "Accept": "application/json",
    },
    timeout=30,
)
print(response.json())

Endpoints

Method	Path	What it does
GET	`/atms/v1/atm`	Returns detailed information about an ATM location. This information can be used to display ATMs on a map, provide driving directions, or show special ATM feat
GET	`/atms/v1/country`	Returns countries with valid ATM locations.
GET	`/atms/v1/countrysubdivision`	Returns country subdivisions that have ATM locations. A country subdivision is a segment within a country (ex state or province). Country subdivisions are onl
GET	`/merchants/v1/category`	Returns a list of all merchant categories for contactless and cash back merchants (example: Airline, Retail, etc.).
GET	`/merchants/v1/country`	Returns countries that have Merchants offering the following services: accept contactless-enabled cards and devices, allow customers to add money to an eligible
GET	`/merchants/v1/countrysubdivision`	Returns country subdivisions that have Merchants offering the following services: accept contactless-enabled cards and devices, allow customers to add money to
GET	`/merchants/v1/merchant`	Returns merchant location information for merchants offering the following services: accept contactless-enabled cards and devices, allow customers to add money