Free Reverse Geocoding API — Coordinates to Clean Addresses
Turn latitude/longitude into structured addresses with street, district, city, region, and postal code—plus rich OpenStreetMap metadata. Start free with 3,000 hits/month (20 rps) on Standard, or go Premium for unlimited hits and 100 rps at just Rp 50,000/month (~$3.50).
Structured, production-ready reverse geocoding
The Reverse Geocoding API instantly converts raw coordinates into human-friendly addresses. It returns formatted display names plus granular fields—road, village, district, city, region, postcode—and OpenStreetMap metadata for deeper context.
Use it to power logistics, delivery, mapping, fraud/risk, IoT, and mobility apps that need fast, accurate addresses with minimal latency. Built on CDN delivery with stable uptime, so your flows stay responsive at scale.
Data stays in sync with OpenStreetMap, so when addresses are updated, your app reflects it automatically. Responses are lightweight JSON with structured address components and rich metadata.
Fast & Reliable
Low-latency responses on CDN-backed infra with 99.9% uptime.
Rich OSM Data
Street, admin areas, postcode, extratags, bounding boxes in one call.
Generous Free Tier
3,000 hits/month and 20 rps to prototype before you scale.
Simple Integration
Single GET endpoint, clean JSON, easy to drop into web or mobile.
Start free, scale when you need
Standard: 3,000 hits/month, 20 req/sec (free). Premium: unlimited hits, 100 req/sec at Rp 50,000/month (≈ $3.50). Points per hit: 0 for this API.
Standard (Free)
3,000 hits/month • 20 req/sec • No commitment fees
🧪 Build & Test
Great for staging, logistics pilots, mapping previews.
🚀 Premium
Unlimited hits, 100 req/sec. Fixed Rp 50,000/month (≈ $3.50).
🧾 Zero Surprises
No setup fees, no hidden charges. Straightforward limits.
Fits every first location workflow
Ship accurate addresses anywhere you have coordinates.
Reverse Geocoding API Documentation
This page is a teaser. Log in to the dashboard to see the full reference, request/response schemas, headers, limits, and the interactive explorer.
{{base-url}}/location/reverse-geocode?lat=-6.2146&lon=106.8289
Converts latitude/longitude into a full address with street, admin hierarchy, postcode, extratags, and bounding box.
| Property | Value |
|---|---|
| Base URL | {{base-url}} |
| Auth | x-api-co-id: YOUR_API_KEY |
| Method | GET |
| Pricing | Standard: Free 3,000 hits/month (20 rps), 0 points per hit • Premium: Unlimited, 100 rps, Rp 50,000/month |
| Query Param | Type | Description |
|---|---|---|
lat |
string (required) | Latitude in decimal degrees. |
lon |
string (required) | Longitude in decimal degrees. |
curl --location '{{base-url}}/location/reverse-geocode?lat=-6.2146&lon=106.8289' \
--header 'x-api-co-id: your_api_key_here'
{
"is_success": true,
"message": "Success",
"data": {
"place_id": 54637009,
"display_name": "Jalan RS. Mata Aini, RW 05, Karet, Setiabudi, Jakarta Selatan, Daerah Khusus Ibukota Jakarta, 12910, Indonesia",
"lat": "-6.2145938",
"lon": "106.8289057",
"address": {
"road": "Jalan RS. Mata Aini",
"suburb": "Setiabudi",
"city": "Jakarta Selatan",
"region": "Jawa",
"postcode": "12910",
"country": "Indonesia"
},
"extratags": {
"lanes": "1",
"surface": "asphalt"
},
"boundingbox": [
"-6.2149649",
"-6.2134748",
"106.8288502",
"106.8291525"
]
}
}
| Error | HTTP | Message | Resolution |
|---|---|---|---|
| Missing API key | 401 | API key required in x-api-co-id header |
Add your dashboard API key to the header. |
| Missing lat/lon | 400 | lat is required / lon is required |
Provide both latitude and longitude query params. |
| Invalid coordinates | 400 | Invalid latitude/longitude |
Send valid decimal degrees (e.g., -6.2146, 106.8289). |
| Insufficient points (Premium) | 402 | Insufficient points balance. Please top up to continue. |
Top up through the dashboard and retry. |
| Rate limit exceeded | 429 | Too many requests |
Reduce request rate or upgrade to Premium for higher throughput. |
Login to see the full docs
Access complete request/response schemas, headers, limits, and more inside the dashboard.
Launch reverse geocoding-aware apps faster
Start free with 0 points per hit. Keep address data fresh without manual updates.
