Skip to main content
GET
/
v2
/
geolocation
Get Geolocation
curl --request GET \
  --url https://api.calmyx.com/v2/geolocation \
  --header 'Authorization: <authorization>'
{
  "status": "OK",
  "request": {
    "address": "1600 Amphitheatre Parkway, Mountain View, CA 94043"
  },
  "response": {
    "lat": 37.4220656,
    "lng": -122.0840897
  }
}

​
Overview

The Get Geolocation API validates an address and returns its geographic coordinates (latitude and longitude). Use this to convert human-readable addresses to coordinates for the Quiet Score™ endpoints.
To obtain an API key, register for an account and subscribe to a plan.

​
Authorization

​
Authorization
string
required
Your API key for authentication

​
Query Parameters

​
address
string
required
The full address to geocode (e.g., “1600 Amphitheatre Parkway, Mountain View, CA 94043”)
{
  "status": "OK",
  "request": {
    "address": "1600 Amphitheatre Parkway, Mountain View, CA 94043"
  },
  "response": {
    "lat": 37.4220656,
    "lng": -122.0840897
  }
}

​
Response Fields

FieldTypeDescription
statusstringStatus of the request (“OK” for success)
request.addressstringThe original address provided in the request
response.latnumberLatitude coordinate of the address
response.lngnumberLongitude coordinate of the address

​
Use Cases

  • Pre-validation: Verify that an address is valid before requesting a Quiet Score™
  • Coordinate retrieval: Get coordinates for addresses to use with the Get Quiet Score™ endpoint
  • Batch preparation: Convert a list of addresses to coordinates for use with the Batch Quiet Score™ endpoint

​
Notes

  • The address must be a valid, complete address that can be geocoded
  • Addresses are validated and standardized before geocoding
  • Returns the most accurate coordinates available for the given address
  • Coordinates are returned in decimal degrees format (WGS84)
  • Each successful request counts toward your API usage