get_atm_details

The get_atm_details tool retrieves detailed information about a specific ATM by its ID.

Parameters

Parameter	Type	Required	Description
atmId	number	Yes	The unique ATM identifier

Example Usage

"What are the details for ATM #456?"

Tool call:

{
  "name": "get_atm_details",
  "arguments": {
    "atmId": 456
  }
}

Response

{
  "success": true,
  "data": {
    "atm": {
      "id": 456,
      "name": "Shell Station - Collins Ave",
      "address": "456 Collins Ave",
      "city": "Miami Beach",
      "state": "FL",
      "country": "US",
      "coordinates": {
        "lat": 25.7907,
        "lon": -80.1300
      },
      "status": "open",
      "hours": {
        "monday": "6:00 AM - 11:00 PM",
        "tuesday": "6:00 AM - 11:00 PM",
        "wednesday": "6:00 AM - 11:00 PM",
        "thursday": "6:00 AM - 11:00 PM",
        "friday": "6:00 AM - 12:00 AM",
        "saturday": "7:00 AM - 12:00 AM",
        "sunday": "7:00 AM - 10:00 PM"
      },
      "currentHours": "6:00 AM - 11:00 PM",
      "links": {
        "googleMaps": "https://maps.google.com/?q=...",
        "directions": "https://maps.google.com/dir/...",
        "reviews": "https://maps.google.com/reviews/...",
        "photo": "https://bytefederal.com/atm/456/photo.jpg"
      }
    }
  }
}

Response Fields

Field	Type	Description
id	number	Unique ATM identifier
name	string	Location/business name
address	string	Full street address
city	string	City name
state	string	State code
country	string	Country code
coordinates.lat	number	Latitude
coordinates.lon	number	Longitude
status	string	Current status (“open” or “closed”)
hours	object	Operating hours by day of week
currentHours	string	Today’s operating hours
links.googleMaps	string	Google Maps location link
links.directions	string	Google Maps directions link
links.reviews	string	Google Maps reviews link
links.photo	string	ATM photo URL (if available)

Error Responses

ATM Not Found

{
  "success": false,
  "error": {
    "code": "ATM_NOT_FOUND",
    "message": "No ATM found with ID 999"
  }
}

Natural Language Examples

User Says	Interpreted As
”Tell me about ATM 456”	Get details for ID 456
”What are the hours for the Chevron ATM?”	May need to search first, then get details
”Show me the ATM at 123 Main St”	May need to search first, then get details

Use Cases

• Get Full Hours - See the complete weekly schedule
• Get Directions - Access Google Maps links for navigation
• Verify Location - Confirm address and coordinates
• Check Reviews - Link to Google Maps reviews

Notes

• The ATM ID is typically obtained from a find_nearest_bitcoin_atm search
• Hours are returned in the ATM’s local timezone
• Photo URLs may be null if no photo is available