Skip to content
Wink

City Search

GET
/reference-data/geo-ip/city/{searchTerm}
 
curl --request GET \
  --url https://api.wink.travel/reference-data/geo-ip/city/Los%20Ang \
  --header 'Wink-Version: 2.0'

Searches for city matching search term.

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
searchTerm
required
string
""

Search for city by search term

Example 
Los Ang

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 ”

OK

Media type application/json
Array<object>

Uses MaxMind’s city lite db to persist GeoIpLightweight objects in our own db.

object
geoNameId
required

GeoNameLightweight identifiers taken from https://geonames.org.

string
"" >= 1 characters
localeCode
required

Locale code

string
"" >= 1 characters
continentCode
required

Continent code

string
"" >= 1 characters
continentName
required

Continent name

string
"" >= 1 characters
countryIsoCode
required

Country ISO code

string
"" >= 1 characters
countryName
required

Country name

string
"" >= 1 characters
cityName
required

City name

string
"" >= 1 characters
timezone
required

Timezone

string
"" >= 1 characters
subDivision1Code

Sub-division 1 code

string
""
subDivision1Name

Sub-division 1 name

string
""
subDivision2Code

Sub-division 2 code

string
""
subDivision2Name

Sub-division 2 name

string
""
Example 
[
  null
]

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

500

Section titled “500 ”

Internal Server Error

object
Example generated
{}