Skip to main content
GET
Find a place by name or address and get its coordinates

Authorizations

Authorization
string
header
required

API key created in the JustRouting dashboard.

Query Parameters

text
string

Free-form address to search, e.g. Marina Bay Sands, Singapore. Mutually exclusive with the structured fields.

name
string

Name of the place, e.g. Marina Bay Sands.

housenumber
string

House or building number, e.g. 10.

street
string

Street name, e.g. Bayfront Avenue.

postcode
string

Postal code, e.g. 018956.

city
string

City or locality, e.g. Singapore.

state
string

State or region.

country
string

Country, e.g. Singapore — the strongest disambiguator for common, abbreviated, or misspelled names.

limit
integer
default:5

Maximum number of results to return.

offset
integer
default:0

Skip the first offset results before applying limit.

filter
string

Restrict results, e.g. countrycode:sg; repeatable, all filters apply.

bias
string

Steer results toward a location, e.g. proximity:103.8,1.3; adds a distance field to each result.

type
string

Restrict to a feature type, e.g. street or city.

lang
string

Preferred language for results, e.g. en.

format
string
default:json

Response format; json is the only documented value.

Response

Matching places, ordered by relevance

results
object[]

Matching places, ordered by relevance (best first); empty when nothing matches.

query
object

Echo of how the API interpreted the request.