Skip to main content
POST
https://api.calmyx.com
/
v2
/
quietness
{
  "geolocations": [
    { "lat": 37.3673694, "lng": -121.9811256 },
    { "lat": 40.4806059, "lng": -79.2137782 },
    { "lat": 33.0047266, "lng": -96.8024372 }
  ]
}

{
  "status": "OK",
  "request": {
    "total_geolocations": 3,
    "geolocations": [
      { "lat": 37.3673694, "lng": -121.9811256 },
      { "lat": 40.4806059, "lng": -79.2137782 },
      { "lat": 33.0047266, "lng": -96.8024372 }
    ]
  },
  "response": [
    {
      "geolocation_1": {
        "status": "OK",
        "request": {
          "lat": 37.3673694,
          "lng": -121.9811256
        },
        "response": {
          "quietness_score": 5,
          "Top 5 sources of noise": [
            {
              "name": "Chromite Drive",
              "distance": 0.109
            },
            {
              "name": "Monroe Street",
              "distance": 0.142
            },
            {
              "name": "Caltrain Peninsula Subdivision",
              "distance": 0.235
            },
            {
              "name": "Bowers Avenue",
              "distance": 0.247
            },
            {
              "name": "Wilcox High School",
              "distance": 0.222
            }
          ],
          "score_range": {
            "min": 0,
            "max": 10
          }
        },
        "timestamp_utc": "2025-12-12T17:06:21.793838"
      }
    },
    {
      "geolocation_2": {
        "status": "OK",
        "request": {
          "lat": 40.4806059,
          "lng": -79.2137782
        },
        "response": {
          "quietness_score": 9,
          "Top 5 sources of noise": [
            {
              "name": "Dunlap Drive",
              "distance": 0.108
            }
          ],
          "score_range": {
            "min": 0,
            "max": 10
          }
        },
        "timestamp_utc": "2025-12-12T17:06:21.798163"
      }
    },
    {
      "geolocation_3": {
        "status": "OK",
        "request": {
          "lat": 33.0047266,
          "lng": -96.8024372
        },
        "response": {
          "quietness_score": 8,
          "Top 5 sources of noise": [
            {
              "name": "Bentwood Trail",
              "distance": 0.044
            },
            {
              "name": "Mapleshade Lane",
              "distance": 0.258
            },
            {
              "name": "Lloyd Circle",
              "distance": 0.289
            },
            {
              "name": "Bentwood Trail Presbyterian Church",
              "distance": 0.136
            },
            {
              "name": "Residential streets",
              "distance": 0.042
            }
          ],
          "score_range": {
            "min": 0,
            "max": 10
          }
        },
        "timestamp_utc": "2025-12-12T17:06:21.802045"
      }
    }
  ]
}

​
Overview

The Batch Quietness Score API allows you to retrieve quietness scores for multiple locations in a single request. This is useful when you need to analyze several locations at once.
To obtain an API key, please contact our sales team.

​
Authorization

​
Authorization
string
required
Your API key for authentication

​
Request Body

​
geolocations
array
required
An array of geolocation objects, each containing lat and lng properties
{
  "geolocations": [
    { "lat": 37.3673694, "lng": -121.9811256 },
    { "lat": 40.4806059, "lng": -79.2137782 },
    { "lat": 33.0047266, "lng": -96.8024372 }
  ]
}

{
  "status": "OK",
  "request": {
    "total_geolocations": 3,
    "geolocations": [
      { "lat": 37.3673694, "lng": -121.9811256 },
      { "lat": 40.4806059, "lng": -79.2137782 },
      { "lat": 33.0047266, "lng": -96.8024372 }
    ]
  },
  "response": [
    {
      "geolocation_1": {
        "status": "OK",
        "request": {
          "lat": 37.3673694,
          "lng": -121.9811256
        },
        "response": {
          "quietness_score": 5,
          "Top 5 sources of noise": [
            {
              "name": "Chromite Drive",
              "distance": 0.109
            },
            {
              "name": "Monroe Street",
              "distance": 0.142
            },
            {
              "name": "Caltrain Peninsula Subdivision",
              "distance": 0.235
            },
            {
              "name": "Bowers Avenue",
              "distance": 0.247
            },
            {
              "name": "Wilcox High School",
              "distance": 0.222
            }
          ],
          "score_range": {
            "min": 0,
            "max": 10
          }
        },
        "timestamp_utc": "2025-12-12T17:06:21.793838"
      }
    },
    {
      "geolocation_2": {
        "status": "OK",
        "request": {
          "lat": 40.4806059,
          "lng": -79.2137782
        },
        "response": {
          "quietness_score": 9,
          "Top 5 sources of noise": [
            {
              "name": "Dunlap Drive",
              "distance": 0.108
            }
          ],
          "score_range": {
            "min": 0,
            "max": 10
          }
        },
        "timestamp_utc": "2025-12-12T17:06:21.798163"
      }
    },
    {
      "geolocation_3": {
        "status": "OK",
        "request": {
          "lat": 33.0047266,
          "lng": -96.8024372
        },
        "response": {
          "quietness_score": 8,
          "Top 5 sources of noise": [
            {
              "name": "Bentwood Trail",
              "distance": 0.044
            },
            {
              "name": "Mapleshade Lane",
              "distance": 0.258
            },
            {
              "name": "Lloyd Circle",
              "distance": 0.289
            },
            {
              "name": "Bentwood Trail Presbyterian Church",
              "distance": 0.136
            },
            {
              "name": "Residential streets",
              "distance": 0.042
            }
          ],
          "score_range": {
            "min": 0,
            "max": 10
          }
        },
        "timestamp_utc": "2025-12-12T17:06:21.802045"
      }
    }
  ]
}

​
Response Fields

FieldTypeDescription
quietness_scorenumberScore from 0-10 (higher = quieter)
Top 5 sources of noisearrayArray of noise source objects
Top 5 sources of noise[].namestringName of the noise source
Top 5 sources of noise[].distancenumberDistance in miles from the location

​
Notes

  • Maximum of 100 geolocations can be processed in a single request
  • Each geolocation in the request must have both lat and lng properties
  • For larger batches, use the Create Session endpoint for async processing
  • Results are returned in the same order as the input geolocations
  • The score range is 0-10 for each location
  • Distance values are in miles