Skip to content
Wink

Show countries

GET
/reference-data/country/list
 
curl --request GET \
  --url https://api.wink.travel/reference-data/country/list \
  --header 'Authorization: Bearer <token>' \
  --header 'Wink-Version: 2.0'

Returns all supported countries as lightweight records, sorted by country name. Open reference data requiring no authentication.

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

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 list of all countries

Media type application/json
Array<object>

Country

object
iso

ISO code

string
""
iso3

3 character ISO code

string
""
isoNumeric

Numeric ISO code

integer format: int32
""
fips

FIPS country code

string
""
name

Country name

string
""
capital

Country capital

string
""
area

Area in square kilometers

number format: float
""
population

Country population

integer format: int64
""
continent

Continent code

string
""
topLevelDomain

Country TLD

string
""
currencyCode

Currency code

string
"" /^[A-Z]{3}$/
currencyName

Currency name

string
""
phone

Calling code

string
""
postalCodeFormat

Postal code format

string
""
postalCodeRegEx

Postal code regular expression

string
""
languages

Country languages

Array<string>
geoNameId

Country GeoNames identifier

string
""
neighbors

Neighboring countries

Array<string>
Example 
[
  "{\n  \"iso\": \"TH\",\n  \"iso3\": \"THA\",\n  \"isoNumeric\": 764,\n  \"fips\": \"TH\",\n  \"name\": \"Thailand\",\n  \"capital\": \"Bangkok\",\n  \"area\": 514000.0,\n  \"population\": 69428524,\n  \"continent\": \"AS\",\n  \"topLevelDomain\": \".th\",\n  \"currencyCode\": \"THB\",\n  \"currencyName\": \"Baht\",\n  \"phone\": \"66\",\n  \"postalCodeFormat\": \"#####\",\n  \"postalCodeRegEx\": \"^(\\d{5})$\",\n  \"languages\": [\"th\"],\n  \"geoNameId\": \"1605651\",\n  \"neighbors\": [\"LA\", \"MM\", \"KH\", \"MY\"]\n}"
]

400

Section titled “400 ”

Bad Request — missing or invalid request parameter or body

Media type application/problem+json
object
type
string format: uri
title
string
status
integer format: int32
detail
string
instance
string format: uri
properties
object
key
additional properties
key
additional properties
""
Example

401

Section titled “401 ”

Unauthorized — authentication is required or the session has expired

Media type application/problem+json
object
type
string format: uri
title
string
status
integer format: int32
detail
string
instance
string format: uri
properties
object
key
additional properties
key
additional properties
""
Example

403

Section titled “403 ”

Forbidden — authenticated but lacking the required permission or scope

Media type application/problem+json
object
type
string format: uri
title
string
status
integer format: int32
detail
string
instance
string format: uri
properties
object
key
additional properties
key
additional properties
""
Example

404

Section titled “404 ”

Not Found — the requested resource does not exist

Media type application/problem+json
object
type
string format: uri
title
string
status
integer format: int32
detail
string
instance
string format: uri
properties
object
key
additional properties
key
additional properties
""
Example

405

Section titled “405 ”

Method Not Allowed — the HTTP verb is not supported on this endpoint

Media type application/problem+json
object
type
string format: uri
title
string
status
integer format: int32
detail
string
instance
string format: uri
properties
object
key
additional properties
key
additional properties
""
Example

415

Section titled “415 ”

Unsupported Media Type — use application/json

Media type application/problem+json
object
type
string format: uri
title
string
status
integer format: int32
detail
string
instance
string format: uri
properties
object
key
additional properties
key
additional properties
""
Example

500

Section titled “500 ”

Internal Server Error — an unexpected failure occurred on the server

Media type application/problem+json
object
type
string format: uri
title
string
status
integer format: int32
detail
string
instance
string format: uri
properties
object
key
additional properties
key
additional properties
""
Example

503

Section titled “503 ”

Service Unavailable — a downstream dependency is unreachable

Media type application/problem+json
object
type
string format: uri
title
string
status
integer format: int32
detail
string
instance
string format: uri
properties
object
key
additional properties
key
additional properties
""
Example