Developer documentation

# Geocoding API docs.  
An address in, coordinates out.

Geocode addresses, suggest places as people type, and find what’s around a point. Start with one JSON request. No special SDK required.

[Get an API key ↗](https://opengeocoding.com/login?mode=signup) [Connect Claude with OAuth →](https://opengeocoding.com/docs/mcp) [Download OpenAPI ↓](https://opengeocoding.com/openapi.json)

This is the managed API for [OpenGeocoding](https://github.com/Mokto/opengeocoding), the source-available geocoding engine we build and maintain. We host the engine and provide API key authentication, usage tracking and account management. The engine's source is public under the PolyForm Shield licence; this hosted service is a separate commercial offering.

Prefer to run the engine yourself? See the [self-hosting instructions on GitHub](https://github.com/Mokto/opengeocoding#readme). The endpoints and authentication below describe the managed API, not the engine’s native interface.

Your first request

## Up and running in a minute

1. 01 Create a key in the [dashboard](https://opengeocoding.com/dashboard).
2. 02 Send a POST with your key and a JSON body.
3. 03 Read coordinates and structured address fields.

cURL 

```
curl 'https://api.opengeocoding.com/v1/search' \
  -H 'x-api-key: YOUR_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"addressString":"Copenhagen"}'
```

The production API base URL is `https://api.opengeocoding.com`. Never put a secret key in browser code; use a [browser key](https://opengeocoding.com/docs/authentication#browser-keys) restricted to your origins.

## Explore the API

6 endpoints

[Search ↗ Turn an address into coordinates. POST/v1/search](https://opengeocoding.com/docs/search)[Autocomplete ↗ Suggest places as someone types. POST/v1/autocomplete](https://opengeocoding.com/docs/autocomplete)[Retrieve suggestion ↗ Get coordinates for a selected suggestion. POST/v1/retrieve](https://opengeocoding.com/docs/retrieve)[Reverse geocoding ↗ Find the addresses nearest a point. POST/v1/reverse](https://opengeocoding.com/docs/reverse)[List regions ↗ List indexed countries and regions. POST/v1/regions](https://opengeocoding.com/docs/regions)[Resolve regions ↗ Find the administrative regions at a point. POST/v1/resolve-region](https://opengeocoding.com/docs/resolve-region) [Using gRPC? The same six methods, keys and credits. Read the transport guide and use the pinned protobuf contract.](https://opengeocoding.com/docs/protocols)

Autocomplete and regions are free of credit charges. Other successful operations spend one credit. [Understand credits and limits →](https://opengeocoding.com/docs/limits)

Show the required data credits wherever you display results. [Data attribution →](https://opengeocoding.com/legal/attributions)

Canonical page: https://opengeocoding.com/docs