Skip to content
Wink

Show by ID

GET
/reference-data/geo/{geoNameId}
 
curl --request GET \
  --url https://api.wink.travel/reference-data/geo/1609350 \
  --header 'Authorization: Bearer <token>' \
  --header 'Wink-Version: 2.0'

Returns a single geo-name by its GeoNames identifier, throwing 404 if none exists.

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
geoNameId
required
string
""

GeoNames database identifier (numeric string)

Example 
1609350

Header Parameters

Section titled “Header Parameters ”
Wink-Version
string
default: 2.0.0
Allowed values: 2.0

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Successfully retrieved geo-name by ID

Media type application/json
string
""
Example

400

Section titled “400 ”

Bad Request

object
type
string format: uri
title
string
status
integer format: int32
detail
string
instance
string format: uri
properties
object
key
additional properties
Example generated
{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "instance": "https://example.com",
  "properties": {
    "additionalProperty": "example"
  }
}

401

Section titled “401 ”

Unauthorized

Media type */*
object
type
string format: uri
title
string
status
integer format: int32
detail
string
instance
string format: uri
properties
object
key
additional properties

403

Section titled “403 ”

Forbidden

Media type */*
object
type
string format: uri
title
string
status
integer format: int32
detail
string
instance
string format: uri
properties
object
key
additional properties

404

Section titled “404 ”

Geo-name with the specified ID not found

Media type application/json

GeoNames have been created at https://geonames.org and contain geographical destinations we use as geoname data to associate travel inventory with a location.

object
geoNameId

GeoName identifier

string
""
type

GeoNameLightweight type

string
""
Allowed values: CITY ISLAND OTHER
name

Name of city

string
""
urlName

Url name

string
""
asciiName

Ascii name of city

string
""
location

Coordinate points of the city

object
x
number format: double
y
number format: double
type
string
coordinates
Array<number>
featureCode
string
countryCode
string
timezone

Timezone

string
""
country

Country

object
iso

ISO code

string
""
name

Country name

string
""
capital

Country capital

string
""
continent

Continent code

string
""
currencyCode

Currency code

string
""
currencyName

Currency name

string
""
geoNameId

Country GeoNames identifier

string
""
subCountry

Country sub division

object
name

Sub-country name

string
""
asciiName

Sub-country ascii name

string
""
geoNameId

Sub-country GeoNames identifier

string
""
subSubCountry

Country sub sub division

object
name
string
asciiName
string
geoNameId
string
Example 
null

500

Section titled “500 ”

Internal Server Error

object
Example generated
{}