Documentation

GeoResolver provides a REST API for geocoding — converting addresses to coordinates and coordinates to addresses. All responses are returned as JSON.

Base URL

https://api.georesolver.com/v1

Authentication

All API requests require an API key. Include it in the X-API-Key header:

Header

X-API-Key: gr_live_your_api_key

You can also pass the key as a query parameter for quick testing:

Query parameter (testing only)

GET /v1/geocode?address=...&api_key=gr_live_your_api_key

Create your API key from the Dashboard. Keys are shown once at creation — copy and store them securely.

Endpoints

GET/v1/geocode

Forward geocoding. Convert a street address into geographic coordinates.

Parameters

Name	Type	Required	Description
address	string	Required	Street address to geocode

Example Response

200 OK

{
  "lat": 38.8977,
  "lng": -77.0365,
  "confidence": 0.98,
  "formatted_address": "1600 Pennsylvania Avenue NW, Washington, DC 20500",
  "source": "openstreetmap",
  "components": {
    "house_number": "1600",
    "road": "Pennsylvania Avenue NW",
    "city": "Washington",
    "state": "District of Columbia",
    "postcode": "20500",
    "country": "United States"
  }
}

Try in Playground →

GET/v1/reverse

Reverse geocoding. Convert geographic coordinates into a human-readable address.

Parameters

Name	Type	Required	Description
lat	number	Required	Latitude of the point
lon	number	Required	Longitude of the point

Example Response

200 OK

{
  "lat": 38.8977,
  "lng": -77.0365,
  "confidence": 0.95,
  "formatted_address": "1600 Pennsylvania Avenue NW, Washington, DC 20500",
  "source": "openstreetmap",
  "components": {
    "house_number": "1600",
    "road": "Pennsylvania Avenue NW",
    "city": "Washington",
    "state": "District of Columbia",
    "postcode": "20500",
    "country": "United States"
  }
}

Try in Playground →

Rate Limits

Rate limits are enforced per API key on a per-minute sliding window. When you exceed the limit, the API returns 429 with a Retry-After header indicating how many seconds to wait.

Plan	Requests/month	Rate Limit
Free	1,000	60/min
Pro	50,000	600/min

Error Codes

Errors are returned as JSON with a detail field describing what went wrong.

Status	Code	Description
400	invalid_request	Missing or invalid parameters
401	unauthorized	Invalid or missing API key
403	forbidden	API key has been revoked
404	not_found	Address or location not found
429	rate_limited	Rate limit exceeded — see Retry-After header
500	internal_error	Unexpected server error

Error Response Format

401 Unauthorized

{
  "detail": "Missing API key. Provide X-API-Key header or api_key query parameter."
}

Roadmap

The following endpoints are planned for future releases:

Planned

Land Parcels

Parcel IDs, boundaries, ownership, and geometries

Planned

Land Use Classification

Zoning, NLCD codes, and land cover percentages

Planned

Proximity Analysis

Distance to schools, hospitals, parks, transit, and infrastructure

Planned

MCP Server

Model Context Protocol interface for AI agents