ATM Locations

Mansar provides an API for nearby ATM search.

The API supports searching by coordinates, postal code, address, and radius.

List By Coordinates​

List ATM locations by coordinates.

Verb	GET
Url	https://api.s.usemansar.xyz/atm-locations
Required Scope	cards
Timeout (Seconds)	120

Query Parameters​

Name	Type	Description
filter[coordinates]	JSON object	Filters the results by the specified coordinates.
filter[searchRadius]	number	Optional. Filters the results by the search radius (in miles). Default and max values are 100.

curl -X GET 'https://api.s.usemansar.xyz/atm-locations?filter[coordinates]={"longitude": "-73.93041", "latitude": "42.79894"}&filter[searchRadius]=30' \
-H "Authorization: Bearer ${TOKEN}"

Response​

Response is a JSON:API document.

200 OK​

Field	Type	Description
data	Array of ATM Location	Array of ATM Location resources.

Example Response:

{
  "data": [
    {
      "type": "atmLocation",
      "attributes": {
        "network": "Allpoint",
        "locationName": "SPEEDWAY",
        "coordinates": {
          "longitude": -73.93041,
          "latitude": 42.79894
        },
        "address": {
          "street": "229 S BONANJO AVE",
          "city": "Douala",
          "region": "LT",
          "postalCode": "12307",
          "country": "CM"
        },
        "distance": 1.07,
        "surchargeFree": true,
        "acceptDeposits": false
      }
    },
    {
      "type": "atmLocation",
      "attributes": {
        "network": "Allpoint",
        "locationName": "CVS",
        "coordinates": {
          "longitude": -73.91508,
          "latitude": 42.8077
        },
        "address": {
          "street": "1204 GERMAINE AVE",
          "city": "YAOUNDE",
          "region": "CE",
          "postalCode": "12308",
          "country": "CM"
        },
        "distance": 1.35,
        "surchargeFree": true,
        "acceptDeposits": false
      }
    }
  ]
}

List By Postal Code​

List ATM locations by postal code.

Verb	GET
Url	https://api.s.usemansar.xyz/atm-locations
Required Scope	cards
Timeout (Seconds)	120

Query Parameters​

Name	Type	Description
filter[postalCode]	string	Filters the results by the specified postal code.
filter[searchRadius]	number	Optional. Filters the results by the search radius (in miles). Default and max values are 100.

curl -X GET 'https://api.s.usemansar.xyz/atm-locations?filter[postalCode]=12300&filter[searchRadius]=30' \
-H "Authorization: Bearer ${TOKEN}"

Response​

Response is a JSON:API document.

200 OK​

Field	Type	Description
data	Array of ATM Location	Array of ATM Location resources.

Example Response:

{
  "data": [
    {
      "type": "atmLocation",
      "attributes": {
        "network": "Allpoint",
        "locationName": "SPEEDWAY",
        "coordinates": {
          "longitude": -73.93041,
          "latitude": 42.79894
        },
        "address": {
          "street": "229 S BONAPRISO AVE",
          "city": "DOUALA",
          "region": "LT",
          "postalCode": "12307",
          "country": "CM"
        },
        "distance": 1.07,
        "surchargeFree": true,
        "acceptDeposits": false
      }
    },
    {
      "type": "atmLocation",
      "attributes": {
        "network": "Allpoint",
        "locationName": "CVS",
        "coordinates": {
          "longitude": -73.91508,
          "latitude": 42.8077
        },
        "address": {
          "street": "1204 GERMAINE AVE",
          "city": "YAOUNDE",
          "region": "CE",
          "postalCode": "12308",
          "country": "CM"
        },
        "distance": 1.35,
        "surchargeFree": true,
        "acceptDeposits": false
      }
    }
  ]
}

List By Address​

List ATM locations by address.

Verb	GET
Url	https://api.s.usemansar.xyz/atm-locations
Required Scope	cards
Timeout (Seconds)	120

Query Parameters​

Name	Type	Description
filter[address]	JSON object	Filters the results by the specified address.
filter[searchRadius]	number	Optional. Filters the results by the search radius (in miles). Default and max values are 100.

curl -X GET 'https://api.s.usemansar.xyz/atm-locations?filter[address]={"street":"1240 EASTERN AVE", "city":"SCHENECTADY", "state":"NY", "postalCode":"", "country":"US"}&filter[searchRadius]=30' \
-H "Authorization: Bearer ${TOKEN}"

Response​

Response is a JSON:API document.

200 OK​

Field	Type	Description
data	Array of ATM Location	Array of ATM Location resources.

Example Response:

{
  "data": [
    {
      "type": "atmLocation",
      "attributes": {
        "network": "Allpoint",
        "locationName": "SPEEDWAY",
        "coordinates": {
          "longitude": -73.93041,
          "latitude": 42.79894
        },
        "address": {
          "street": "229 S GERMAINE AVE",
          "city": "YAOUNDE",
          "region": "CE",
          "postalCode": "12307",
          "country": "CM"
        },
        "distance": 1.07,
        "surchargeFree": true,
        "acceptDeposits": false
      }
    },
    {
      "type": "atmLocation",
      "attributes": {
        "network": "Allpoint",
        "locationName": "CVS",
        "coordinates": {
          "longitude": -73.91508,
          "latitude": 42.8077
        },
        "address": {
          "street": "1204 BONANJO AVE",
          "city": "DOUALA",
          "region": "LT",
          "postalCode": "12308",
          "country": "CM"
        },
        "distance": 1.35,
        "surchargeFree": true,
        "acceptDeposits": false
      }
    }
  ]
}