Distance API Documentation

Base Endpoint

GET https://worldwidedistancefinder.com/api/distance

Required Parameters

api_key           (required)
source_lat        (required)
source_lng        (required)
destination_lat   (required)
destination_lng   (required)

Example Request

GET https://worldwidedistancefinder.com/api/distance
?api_key=YOUR_API_KEY
&source_lat=12.98
&source_lng=77.59
&destination_lat=28.61
&destination_lng=77.23

Response Example

{
  "distance_km": 1779.12,
  "plan": "starter",
  "remaining": 9988,
  "map_url": "https://www.google.com/maps/dir/?api=1",
  "source": {
    "lat": 12.0,
    "lng": 77.0,
    "local_time": "Sunday, 18 January 2026 • 06:47 PM"
  },
  "destination": {
    "lat": 28.0,
    "lng": 77.0,
    "local_time": "Sunday, 18 January 2026 • 06:47 PM"
  }
}

Error Handling

HTTP 401 – Invalid API Key
HTTP 429 – Rate limit exceeded