Skip to main content
GET
/
v2
/
listing
/
quietness
Single Location Quietness
curl --request GET \
  --url https://api.calmyx.com/v2/listing/quietness \
  --header 'Authorization: <authorization>'
{
    "status": "OK",
    "request": {
        "lat": 35.0925734,
        "lng": -106.5883558
    },
    "response": {
        "listing_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "lat": 35.092573,
        "lng": -106.588356,
        "quiet_score": 70,
        "quiet_score_range": {
            "min": 0,
            "max": 100
        },
        "quietness_level": "Quiet",
        "quietness_description": "Generally calm with occasional everyday sounds. Comfortable for most people.",
        "quiet_day_night": {
            "day_window_local": "07:00-22:00",
            "night_window_local": "22:00-07:00",
            "quiet_score_day": 75,
            "quiet_score_night": 65,
            "estimated_noise_db_day": 48.2,
            "estimated_noise_db_night": 42.5,
            "noise_db_unit": "dBA"
        },
        "noise_sources": [
            {
                "name": "Highways/Freeways",
                "nearest_source": "Freeway Ramp to San Mateo Boulevard",
                "distance": 0.72,
                "category": "major_highways",
                "estimated_effective_db": 73.5
            },
            {
                "name": "Airports",
                "nearest_source": "12/30",
                "distance": 3.41,
                "category": "airports",
                "estimated_effective_db": 57.6
            },
            {
                "name": "Restaurants/Cafes",
                "nearest_source": "Tully's Italian Deli and Meats",
                "distance": 0.1,
                "category": "restaurants",
                "estimated_effective_db": 54.6
            }
        ],
        "quiet_score_confidence": "high",
        "quiet_score_confidence_values": ["low", "medium", "high"],
        "created_at": "2026-01-15T05:17:16.471569",
        "updated_at": "2026-01-15T05:17:16.471569"
    },
    "timestamp_utc": "2026-01-15T05:17:16.500000"
}

​
Overview

The Single Location Quietness API calculates the Quiet Score™ for any location and automatically manages your listing. This is the primary API for getting quietness data - it creates a new listing if one doesn’t exist, or updates an existing listing based on your plan’s refresh rate.
To obtain an API key, register for an account and subscribe to a plan.

​
How It Works

  1. Check Listing: Verifies if you already have a listing at this geolocation
  2. Check Freshness: If listing exists, checks if the quietness data needs refresh based on your plan
  3. Calculate: If needed, calculates the Quiet Score™ using our patent-pending AI
  4. Update: Creates or updates your listing with the latest quietness data
  5. Return: Provides complete listing data with full quietness analysis

​
Refresh Rates by Plan

PlanRefresh Rate
Trial1 day
Insight30 days
Intelligence7 days
Enterprise1 day

​
Authorization

​
Authorization
string
required
Your API key for authentication

​
Query Parameters

​
lat
float
required
The latitude coordinate of the location (e.g., 37.7749)
​
lng
float
required
The longitude coordinate of the location (e.g., -122.4194)
{
    "status": "OK",
    "request": {
        "lat": 35.0925734,
        "lng": -106.5883558
    },
    "response": {
        "listing_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
        "lat": 35.092573,
        "lng": -106.588356,
        "quiet_score": 70,
        "quiet_score_range": {
            "min": 0,
            "max": 100
        },
        "quietness_level": "Quiet",
        "quietness_description": "Generally calm with occasional everyday sounds. Comfortable for most people.",
        "quiet_day_night": {
            "day_window_local": "07:00-22:00",
            "night_window_local": "22:00-07:00",
            "quiet_score_day": 75,
            "quiet_score_night": 65,
            "estimated_noise_db_day": 48.2,
            "estimated_noise_db_night": 42.5,
            "noise_db_unit": "dBA"
        },
        "noise_sources": [
            {
                "name": "Highways/Freeways",
                "nearest_source": "Freeway Ramp to San Mateo Boulevard",
                "distance": 0.72,
                "category": "major_highways",
                "estimated_effective_db": 73.5
            },
            {
                "name": "Airports",
                "nearest_source": "12/30",
                "distance": 3.41,
                "category": "airports",
                "estimated_effective_db": 57.6
            },
            {
                "name": "Restaurants/Cafes",
                "nearest_source": "Tully's Italian Deli and Meats",
                "distance": 0.1,
                "category": "restaurants",
                "estimated_effective_db": 54.6
            }
        ],
        "quiet_score_confidence": "high",
        "quiet_score_confidence_values": ["low", "medium", "high"],
        "created_at": "2026-01-15T05:17:16.471569",
        "updated_at": "2026-01-15T05:17:16.471569"
    },
    "timestamp_utc": "2026-01-15T05:17:16.500000"
}

​
Score Interpretation

Score RangeRatingWhat Living There Feels Like
80-100Very QuietConsistently calm with minimal environmental noise. Quiet conditions during both day and night.
60-79QuietLow noise levels with occasional everyday sounds. Generally comfortable for most lifestyles.
40-59ModerateNoticeable background noise typical of urban or suburban areas. Usually manageable over time.
20-39NoisyFrequent or elevated noise levels that may affect comfort, concentration, or sleep.
0-19Very NoisyPersistent or high-intensity noise that significantly shapes the daily sound environment.

​
Response Fields

FieldTypeDescription
listing_idstringUnique identifier for your listing
latnumberLatitude of the listing (rounded to 6 decimal places)
lngnumberLongitude of the listing (rounded to 6 decimal places)
quiet_scorenumberScore from 0-100 (higher = quieter)
quiet_score_rangeobjectThe valid range for the quiet score (min: 0, max: 100)
quietness_levelstringHuman-readable rating: “Very Quiet”, “Quiet”, “Moderate”, “Noisy”, or “Very Noisy”
quietness_descriptionstringDescription of what living at this location feels like
quiet_day_nightobjectDay/night specific quietness data
noise_sourcesarrayArray of noise source objects
quiet_score_confidencestringConfidence level: “low”, “medium”, or “high”
quiet_score_confidence_valuesarrayPossible confidence values
created_atstringISO 8601 timestamp of when the listing was created
updated_atstringISO 8601 timestamp of when the listing was last updated

​
Day/Night Fields (quiet_day_night)

The quiet_day_night object provides separate quietness analysis for daytime and nighttime periods:
FieldTypeDescription
day_window_localstringDaytime hours (e.g., “07:00-22:00”)
night_window_localstringNighttime hours (e.g., “22:00-07:00”)
quiet_score_daynumberQuiet Score™ during daytime (0-100)
quiet_score_nightnumberQuiet Score™ during nighttime (0-100)
estimated_noise_db_daynumberEstimated noise level during day in dBA
estimated_noise_db_nightnumberEstimated noise level during night in dBA
noise_db_unitstringUnit of measurement for dB values (“dBA”)
Day/night scores account for time-specific noise patterns:
  • Daytime: Schools, construction, commercial activity, heavier traffic
  • Nighttime: Reduced traffic, closed businesses, but potential nightlife noise

​
Noise Source Fields

FieldTypeDescription
noise_sources[].namestringCategory display name (e.g., “Highways/Freeways”)
noise_sources[].nearest_sourcestringClosest source of noise for this category
noise_sources[].distancenumberDistance in miles from the location
noise_sources[].categorystringMachine-readable category key
noise_sources[].estimated_effective_dbnumberEstimated effective dB level at location

​
Response Status Values

StatusDescription
OKListing was successfully created/updated
LIMIT_REACHEDYour plan’s listing limit has been reached. Quietness data is still returned, but no listing was created.

​
Notes

  • The Quiet Score™ is calculated using our patent-pending AI that analyzes 47+ environmental factors
  • Listings are automatically managed - no need to call separate APIs
  • If you’ve reached your listing limit, the response will have status: "LIMIT_REACHED" - quietness data is still calculated and returned, but no listing is created
  • Coordinates should be in decimal degrees format (WGS84)
  • Day/night scores help users understand noise patterns throughout the day - night scores are typically higher (quieter) for residential areas