# Locations API API

> Locations API API on Apizie: 7 endpoints (Returns detailed information about an ATM location. This information can be used to display ATMs on a map,…, Returns countries with valid ATM locations., Returns country subdivisions that have ATM locations. A country subdivision is a segment within a country…, Returns a list of all merchant categories for contactless and cash back merchants (example: Airline, Retail,…, …) returned as clean JSON through one API key. 7 endpoints are live now. Call it over REST at https://apizie.tech/v1/open-data:mastercard-locations/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `open-data:mastercard-locations`
- Category: Open Data
- Status: live
- Source: https://mastercard.com
- Page: https://apizie.tech/api/open-data/mastercard-locations
- OpenAPI: https://apizie.tech/api/open-data/mastercard-locations/openapi.json

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

## Endpoints

### Returns detailed information about an ATM location. This information can be used to display ATMs on a map,…
`GET https://apizie.tech/v1/open-data:mastercard-locations/get-atms-v1-atm`

| Parameter | Type | Required | Description |
|---|---|---|---|
| PageOffset | integer | yes | Zero-based offset where the response will start. The actual start position is this value +1. An offset of 10 starts at item 11. Combined… |
| PageLength | integer | yes | Maximum number of items to retrieve within the current "page" of results. |
| AddressLine1 | string | no | Line 1 of the street address for the merchant location. Usually includes the street number and name. This parameter is ignored if latitude… |
| AddressLine2 | string | no | Line 2 of the street address usually an apartment number or suite number. This parameter is used rarely and is ignored if latitude and… |
| City | string | no | The name of the city for a merchant location. This parameter is ignored if latitude and longitude are provided. If you provide this… |
| CountrySubdivision | string | no | The state or province for a merchant location (only supported for US and Canada locations). This parameter is ignored if latitude and… |
| PostalCode | string | no | The zip code or postal code for a merchant location. This parameter is ignored if latitude and longitude are provided. If you provide this… |
| Country | string | no | Any three digit country code for an ATM location. Valid values are Three digit alpha country code as defined in ISO 3166-1. This parameter… |
| Latitude | number | no | The latitude of a merchant location. If latitude is provided longitude must also be provided. |
| Longitude | number | no | The longitude of a merchant location. If longitude is provided latitude must also be provided. |
| DistanceUnit | string | no | Indicates the unit for the radius as well as the units of the distance of each location from the basepoint in the response. |
| Radius | integer | no | This is the radius from the search point in the distance unit you set. For example if you want to search for locations within 50 miles of… |
| SupportEMV | integer | no | This indicates whether the ATM should have the ability to read chip cards or not. |
| InternationalMaestroAccepted | integer | no | This field will provide ATM Terminals which can still process Maestro transactions but are not yet EMV chip reader enabled. Information… |

### Returns countries with valid ATM locations.
`GET https://apizie.tech/v1/open-data:mastercard-locations/get-atms-v1-country`

### Returns country subdivisions that have ATM locations. A country subdivision is a segment within a country…
`GET https://apizie.tech/v1/open-data:mastercard-locations/get-atms-v1-countrysubdivision`

| Parameter | Type | Required | Description |
|---|---|---|---|
| Country | string | yes | Any three digit country code as defined in ISO 3166-1. "USA" or "CAN" |

### Returns a list of all merchant categories for contactless and cash back merchants (example: Airline, Retail,…
`GET https://apizie.tech/v1/open-data:mastercard-locations/get-merchants-v1-category`

### Returns countries that have Merchants offering the following services: accept contactless-enabled cards and…
`GET https://apizie.tech/v1/open-data:mastercard-locations/get-merchants-v1-country`

| Parameter | Type | Required | Description |
|---|---|---|---|
| details | string | yes | This is the type of merchant location. Options "acceptance.paypass" "topup.repower" "products.prepaidtravelcard" and "offers.easysavings" |

### Returns country subdivisions that have Merchants offering the following services: accept contactless-enabled…
`GET https://apizie.tech/v1/open-data:mastercard-locations/get-merchants-v1-countrysubdivision`

| Parameter | Type | Required | Description |
|---|---|---|---|
| details | string | yes | This is the type of merchant location. Options "acceptance.paypass" "topup.repower" "products.prepaidtravelcard" and "offers.easysavings" |
| country | string | yes | Any three digit country code as defined in ISO 3166-1. For example "USA or "CAN" |

### Returns merchant location information for merchants offering the following services: accept…
`GET https://apizie.tech/v1/open-data:mastercard-locations/get-merchants-v1-merchant`

| Parameter | Type | Required | Description |
|---|---|---|---|
| Details | string | yes | Type of merchant location. Options are "acceptance.paypass" "topup.repower" "products.prepaidtravelcard" "offers.easysavings" and… |
| PageOffset | integer | yes | Zero-based offset where the response will start. The actual start position is this value +1. An offset of 10 starts at item 11. Combined… |
| PageLength | integer | yes | Maximum number of items to retrieve within the current "page" of results. |
| Category | string | no | Category of the merchant location. See the Categories (Merchant) resource for a list of valid categories. This parameter is only valid for… |
| AddressLine1 | string | no | Line 1 of the street address for the merchant location. Usually includes the street number and name. This parameter is ignored if latitude… |
| AddressLine2 | string | no | Line 2 of the street address usually an apartment number or suite number. This parameter is used rarely and is ignored if latitude and… |
| City | string | no | Name of the city for a merchant location. This parameter is ignored if latitude and longitude are provided. If you provide this parameter… |
| CountrySubdivision | string | no | State or province for a merchant location (only supported for US and Canada locations). This parameter is ignored if latitude and… |
| PostalCode | string | no | Zip code or postal code for a merchant location. This parameter is ignored if latitude and longitude are provided. If you provide this… |
| Country | string | no | Any three digit country code for an ATM location. Valid values are Three digit alpha country code as defined in ISO 3166-1. This parameter… |
| Latitude | number | no | Latitude of a merchant location. If latitude is provided longitude must also be provided. |
| Longitude | number | no | Longitude of a merchant location. If longitude is provided latitude must also be provided. |
| DistanceUnit | string | no | Indicates the unit for the radius as well as the units of the distance of each location from the basepoint in the response. |
| Radius | integer | no | This is the radius from the search point in the distance unit you set. For example if you want to search for locations within 50 miles of… |
| OfferMerchantID | string | no | Unique identifier that represents the merhcant sponsor of an offer. Any valid merchant ID. |

## Example
```
curl "https://apizie.tech/v1/open-data:mastercard-locations/get-atms-v1-atm" \
  -H "x-api-key: $APIZIE_KEY"
```

## FAQ

### How do I call the Locations API API?
Create a free Apizie key, then send GET https://apizie.tech/v1/open-data:mastercard-locations/get-atms-v1-atm with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Locations API API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card.

### Can AI agents use the Locations API API?
Yes. Add the Apizie MCP server (https://apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key open-data:mastercard-locations.

### What is the status of the Locations API API?
Live: works with just an Apizie key