> ## Documentation Index
> Fetch the complete documentation index at: https://lava.so/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Nominatim

> OpenStreetMap-based geocoding API providing forward and reverse geocoding with global coverage.

OpenStreetMap-based geocoding API providing forward and reverse geocoding with global coverage. Best for open-source workflows needing address-to-coordinate conversion without commercial API costs. Unlike Google Maps (commercial, broadest features) or Geocodio (U.S./Canada focus), Nominatim uses crowd-sourced OpenStreetMap data and is free with rate limits.

1 example endpoint available through Lava's AI Gateway. See the [Nominatim API docs](https://nominatim.org/release-docs/latest/api/Overview/) for full documentation.

<Info>This provider is **managed** — no additional setup required.</Info>

<Info>This is a **catch-all provider** — any valid URL under `https://nominatim.openstreetmap.org` is supported. Geocoding API. Construct URL as [https://nominatim.openstreetmap.org/\&#123;endpoint\&#125](https://nominatim.openstreetmap.org/\&#123;endpoint\&#125);. Common endpoints: /search?q=\{query}\&format=json, /reverse?lat=\{lat}\&lon=\{lon}\&format=json, /lookup?osm\_ids=\{ids}\&format=json. The endpoints below are curated examples.</Info>

## Endpoints

### Forward geocode an address

**GET** `https://nominatim.openstreetmap.org/search?q=Berlin&format=json` — Free

<Tabs>
  <Tab title="SDK">
    ```typescript theme={null}
    const data = await lava.gateway('https://nominatim.openstreetmap.org/search?q=Berlin&format=json', { method: 'GET' });
    ```
  </Tab>

  <Tab title="cURL">
    ```bash theme={null}
    curl "https://api.lava.so/v1/forward?u=https%3A%2F%2Fnominatim.openstreetmap.org%2Fsearch%3Fq%3DBerlin%26format%3Djson" \
      -H "Authorization: Bearer $LAVA_SECRET_KEY"
    ```
  </Tab>
</Tabs>

## Next Steps

<CardGroup cols={2}>
  <Card title="All Providers" icon="grid" href="/gateway/supported-providers">
    Browse all supported AI providers
  </Card>

  <Card title="Forward Proxy" icon="route" href="/gateway/forward-proxy">
    Learn how to construct proxy URLs and authenticate requests
  </Card>
</CardGroup>