Skip to main content
curl -X POST https://api.hellotracks.com/api/getplaces --header 'API-Key: ...' -d '
{
    "data": {}
}
'
{
    "places":[
        {
            "creator":"Top Services",
            "address":"1199 East Beach Road, San Francisco, California 94129, United States",
            "color":"",
            "data":[
            ],
            "city":"San Francisco",
            "uid":"n1ub11",
            "country_code":"US",
            "phone":"",
            "postalcode":"94129",
            "name":"East beach",
            "location":{
            "lng":-122.449046,
            "lat":37.8059467
        },
            "state":"California",
            "radius":50,
            "email":"",
            "linkedForms":""
        }
    ],
    "status":0
}
Use this endpoint to retrieve places/locations associated with your organization. Places can represent customer sites, warehouses, offices, or any fixed locations relevant to your operations.

REQUEST

POST https://api.hellotracks.com/api/getplaces

{
  "data": {
    "query": "<place-name>",    // optional
    "uids": ["<place-uid>"],    // optional
    "max": 500                  // optional, defaults to 500
  }
}
query
string
Optional filter to search places by name. Case-insensitive substring match. Minimum 3 characters recommended.
uids
array
Optional array of specific place UIDs to retrieve. When provided, only these places will be returned (subject to permissions).
max
integer
default:500
Maximum number of places to return. Default is 500. Some accounts may have different limits.

Permissions & Filtering

  • Workers with workers_view_places disabled can only see places from their assigned teams
  • Places are automatically filtered by distance from your location (closest first)
  • Only places you have permission to view will be returned

RESPONSE

{
  "status": 0,
  "places": [
    {
      "uid": "<place-uid>",
      "name": "Place name",
      "address": "Full address",
      "city": "City",
      "state": "State/Region",
      "postalcode": "Postal code",
      "country_code": "US",
      "phone": "+1234567890",
      "email": "email@example.com",
      "location": {
        "lat": 37.7749,
        "lng": -122.4194
      },
      "radius": 100,
      "color": "#22c328",
      "creator": "Creator name",
      "linkedForms": "",
      "data": []
    }
  ]
}
status
integer
required
Status code. 0 indicates success.
places
array
required
Array of place objects. Each place contains:
  • uid (string): Unique place identifier
  • name (string): Place name
  • address (string): Street address
  • city (string): City name
  • state (string): State or region
  • postalcode (string): Postal/ZIP code
  • country_code (string): ISO country code
  • phone (string): Contact phone number
  • email (string): Contact email address
  • location (object): Coordinates with lat and lng
  • radius (integer): Check-in radius in meters
  • color (string): Color code in hex format
  • creator (string): Name of user who created the place
  • linkedForms (string): Linked form IDs
  • data (array): Extended custom data as key-value pairs
curl -X POST https://api.hellotracks.com/api/getplaces --header 'API-Key: ...' -d '
{
    "data": {}
}
'
{
    "places":[
        {
            "creator":"Top Services",
            "address":"1199 East Beach Road, San Francisco, California 94129, United States",
            "color":"",
            "data":[
            ],
            "city":"San Francisco",
            "uid":"n1ub11",
            "country_code":"US",
            "phone":"",
            "postalcode":"94129",
            "name":"East beach",
            "location":{
            "lng":-122.449046,
            "lat":37.8059467
        },
            "state":"California",
            "radius":50,
            "email":"",
            "linkedForms":""
        }
    ],
    "status":0
}
I