Skip to main content
GET
/
v2
/
listings
/
by-coordinates
Get Listing by Coordinates
curl --request GET \
  --url https://api.calmyx.com/v2/listings/by-coordinates \
  --header 'Authorization: <authorization>'
{
  "success": true,
  "listing": {
    "listing_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "lat": 37.7749,
    "lng": -122.4194,
    "quiet_score": 72,
    "created_at": "2026-01-10T15:30:00.000Z",
    "updated_at": "2026-01-10T15:30:00.000Z"
  }
}

​
Overview

The Get Listing by Coordinates API retrieves a specific listing using latitude and longitude coordinates. This is useful when you know the location but not the listing ID.
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

​
lat
float
required
The latitude coordinate of the listing (e.g., 37.7749)
​
lng
float
required
The longitude coordinate of the listing (e.g., -122.4194)
{
  "success": true,
  "listing": {
    "listing_id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "lat": 37.7749,
    "lng": -122.4194,
    "quiet_score": 72,
    "created_at": "2026-01-10T15:30:00.000Z",
    "updated_at": "2026-01-10T15:30:00.000Z"
  }
}

​
Response Fields

FieldTypeDescription
successbooleanWhether the request was successful
listingobjectThe listing object
listing.listing_idstringUnique identifier for the listing
listing.latnumberLatitude coordinate
listing.lngnumberLongitude coordinate
listing.quietness_idstringReference ID to the quietness score data record
listing.quiet_scorenumberQuiet Score™ for this location (0-100)
listing.created_atstringISO 8601 timestamp when the listing was created
listing.updated_atstringISO 8601 timestamp when the listing was last updated

​
Notes

  • Coordinates are matched with 6 decimal places of precision (approximately 0.1 meter accuracy)
  • If no exact match is found, a 404 error is returned

​
Use Cases

  • Location lookup: Check if a specific location is already tracked
  • Retrieve listing ID: Get the listing_id for subsequent operations
  • Verify tracking: Confirm a location was added to your listings