---
title: "Nominatim City Geocoding API"
url: "https://devportal.jilson.dev/apis/nominatim-city-geocoding/versions/54640638-d26d-4952-a3c1-22e9555bdefd"
---

# Nominatim City Geocoding API

OpenAPI specification document.

```json
{"openapi":"3.0.3","info":{"title":"Nominatim City Geocoding API","version":"1.0.0","description":"Look up latitude and longitude for a city using the Nominatim Search API. The gateway supplies format=jsonv2 and limit=1 to the upstream."},"servers":[{"url":"https://86ff79c5ed.us.serverless.gateways.konggateway.tech","description":"metering-demo-jilson gateway"}],"paths":{"/v1/geocode/city":{"get":{"operationId":"lookupCityCoordinates","summary":"Look up coordinates by city name","description":"Returns the highest-ranked Nominatim match for the supplied city.","parameters":[{"name":"city","in":"query","required":true,"description":"City name to geocode.","schema":{"type":"string"},"example":"Toronto"},{"name":"countrycodes","in":"query","required":false,"description":"Optional comma-separated ISO 3166-1 alpha-2 country-code filter.","schema":{"type":"string"},"example":"ca"},{"name":"accept-language","in":"query","required":false,"description":"Preferred language for result names.","schema":{"type":"string"},"example":"en"}],"responses":{"200":{"description":"Matching city coordinates.","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/GeocodingResult"}}}}},"400":{"description":"Invalid request."},"401":{"description":"API key is missing or invalid."},"429":{"description":"Rate limit exceeded."}}}}},"components":{"schemas":{"GeocodingResult":{"type":"object","required":["lat","lon","display_name"],"properties":{"place_id":{"type":"integer"},"display_name":{"type":"string"},"lat":{"type":"string","description":"Latitude in decimal degrees."},"lon":{"type":"string","description":"Longitude in decimal degrees."},"boundingbox":{"type":"array","items":{"type":"string"}},"type":{"type":"string"},"importance":{"type":"number"}}}},"securitySchemes":{"apiKeyAuth":{"type":"apiKey","in":"query","name":"apikey"}}},"security":[{"apiKeyAuth":[]}]}
```