ATM Location Lookup

The ATM Location Lookup endpoints allow you to retrieve a list of surcharge-free ATMs from the Allpoint and MoneyPass networks based on a provided zip code. These endpoints return the ATM's name, address, and coordinates, among other details.

The ATM Location Lookup Model

The ATM Location Lookup model provides details about the location, network type, and surcharge status of each ATM.

Properties

Name
name
Type
string
Description
The name of the ATM location (e.g., a store or gas station where the ATM is located).
Name
type
Type
string
Description
The network type of the ATM (e.g., "ALLPOINT NETWORK - US", "MoneyPass ATM").
Name
surcharge_free
Type
boolean
Description
Indicates if the ATM is surcharge-free.
Name
address
Type
object
Description
Contains the ATM location's street, city, state, zipcode, and country.
Name
coordinates
Type
object
Description
Contains the latitude and longitude of the ATM location.
Name
request_id
Type
string
Description
A unique identifier for the request.
Name
request_time
Type
timestamp
Description
The timestamp when the request was made.

POST/v1/utilities/atm/allpoint

Lookup Allpoint ATMs

This endpoint allows you to retrieve a list of Allpoint ATMs located within a provided zip code. Allpoint ATMs are surcharge-free and widely available across various locations in the United States.

Required Attributes

Name
zipcode
Type
string
Description
The zip code to search for ATMs in the Allpoint network.

Request

POST

/v1/utilities/atm/allpoint

curl --location 'https://api.stack-ft.com/utilities/atm/allpoint' \
--header 'Authorization: {api_key}' \
--header 'Content-Type: application/json' \
--data '{
    "zipcode": "21122"
}'

Response

{
  "status": "success",
  "request_id": "bbde28e0-46e7-49b7-b0e3-3ef0f544fbe5",
  "locations": [
    {
      "name": "Harris Teeter",
      "type": "ALLPOINT NETWORK - US",
      "surcharge_free": true,
      "address": {
        "street": "143 Ritchie Hwy",
        "city": "North Severna Park",
        "state": "MD",
        "zipcode": "21146",
        "country": "US"
      },
      "coordinates": {
        "longitude": -76.5651689,
        "latitude": 39.1012505
      }
    },
    {
      "name": "CVS",
      "type": "ALLPOINT NETWORK - US",
      "surcharge_free": true,
      "address": {
        "street": "157 Ritchie Hwy",
        "city": "Severna Park",
        "state": "MD",
        "zipcode": "21146",
        "country": "US"
      },
      "coordinates": {
        "longitude": -76.5650109,
        "latitude": 39.0996138
      }
    }
  ],
  "request_time": "2024-09-08T21:37:17.185Z"
}

POST/v1/utilities/atm/moneypass

Lookup MoneyPass ATMs

This endpoint allows you to retrieve a list of MoneyPass ATMs within a provided zip code. MoneyPass ATMs are surcharge-free and are located in many locations across the United States.

Required Attributes

Name
zipcode
Type
string
Description
The zip code to search for ATMs in the MoneyPass network.

Request

POST

/v1/utilities/atm/moneypass'

curl --location 'https://api.stack-ft.com/utilities/atm/moneypass' \
--header 'Authorization: {api_key}' \
--header 'Content-Type: application/json' \
--data '{
    "zipcode": "21122"
}'

Response

{
  "status": "success",
  "request_id": "2d66377f-4762-4d80-9cf0-3d527b4a79b8",
  "locations": [
    {
      "name": "7ELEVEN-FCTI",
      "type": "MoneyPass ATM",
      "surcharge_free": true,
      "address": {
        "street": "8930 FT. SMALLWOOD RD",
        "city": "PASADENA",
        "state": "MD",
        "zipcode": "21122",
        "country": "US"
      },
      "coordinates": {
        "longitude": -76.5149058,
        "latitude": 39.1318315
      }
    },
    {
      "name": "DASH IN #1530 - MOUNTAIN ROAD",
      "type": "MoneyPass ATM",
      "surcharge_free": true,
      "address": {
        "street": "3900 MOUNTAIN ROAD",
        "city": "PASADENA",
        "state": "MD",
        "zipcode": "21122",
        "country": "US"
      },
      "coordinates": {
        "longitude": -76.521949,
        "latitude": 39.123849
      }
    }
  ],
  "request_time": "2024-09-08T21:37:17.185Z"
}