Skip to content
Bottle

Look up a picked address

GET
/geocode/place/{placeId}
curl --request GET \
  --url https://example.com/geocode/place/example \
  --cookie bottle.session_token=<bottle.session_token>

One suggestion from /geocode/suggest, looked up for keeping: its lines for the form, its point and how sure that is (door: the building; street: only the street). token goes back with the address save as placeToken, so the point is kept without a second lookup while the lines saved are the ones picked. 404 when it is not an address with a point, 503 when the service is off or down. At most 120 a minute for a business (429).

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
placeId
required
string
>= 1 characters <= 2000 characters

Responses

Section titled “Responses”

200

Section titled “200”

The address

Media typeapplication/json
object
line1
required
string
line2
required
string | null
city
required
string | null
postcode
required
string | null
latitude
required
number
longitude
required
number
precision
required
string
Allowed values: door street
token
required
string
Example
{
  "precision": "door"
}

401

Section titled “401”

Not signed in

Media typeapplication/json
object
error
required
string
message
required
string
Example
{
  "error": "not_found",
  "message": "Customer not found"
}

403

Section titled “403”

Not a member, or without the permission this needs

Media typeapplication/json
object
error
required
string
message
required
string
Example
{
  "error": "not_found",
  "message": "Customer not found"
}

404

Section titled “404”

Not an address

Media typeapplication/json
object
error
required
string
message
required
string
Example
{
  "error": "not_found",
  "message": "Customer not found"
}

429

Section titled “429”

Too many in a minute

Media typeapplication/json
object
error
required
string
message
required
string
Example
{
  "error": "not_found",
  "message": "Customer not found"
}

503

Section titled “503”

No address service here, or it is down

Media typeapplication/json
object
error
required
string
message
required
string
Example
{
  "error": "not_found",
  "message": "Customer not found"
}