Get lookup by URL name

GET

/api/public/{managingEntityIdentifier}/lookup/{urlName}

curl --request GET \
  --url 'https://api.wink.travel/api/public//lookup/bangkok-thailand?type=CITY' \
  --header 'Authorization: Bearer <token>' \
  --header 'Wink-Version: 2.0'

• Endpoint

Retrieves full details of a single lookup entry identified by its URL-friendly name and type. The type parameter disambiguates cases where the same destination appears in multiple lookup types (e.g., Bangkok as both CITY and ISLAND).

Authorizations

• oauth2ClientCredentials

Parameters

Path Parameters

managingEntityIdentifier

required

string

""

Managing entity identifier (e.g., account or distribution channel ID)

urlName

required

string

""

URL-friendly slug for the lookup (e.g., bangkok-thailand, the-siam-residences-bangkok-thailand)

Example

bangkok-thailand

Query Parameters

type

required

string

""

Lookup type to filter by (CITY, HOTEL, ACTIVITY, SPA, RESTAURANT, ATTRACTION, ISLAND, COUNTRY, PLACE, MEETING_ROOM)

Example

CITY

Header Parameters

Wink-Version

string

default: 2.0.0

Allowed values: 2.0

Responses

200

Lookup entry found with full details including geolocation

Media type application/json

object

identifier

Unique lookup identifier

string format: uuid

""

type

Type of lookup (CITY, HOTEL, ACTIVITY, SPA, RESTAURANT, ATTRACTION, ISLAND, COUNTRY, PLACE, MEETING_ROOM)

string

""

Allowed values: CITY ISLAND HOTEL SPA MEETING_ROOM RESTAURANT ATTRACTION ACTIVITY PLACE COUNTRY

typeIdentifier

Unique identifier for the lookup type resource (e.g., hotel ID, city geoname ID)

string format: uuid

""

name

Human-readable name of the lookup entry

string

""

urlName

URL-friendly slug that uniquely identifies this lookup within its type and location

string

""

ownerIdentifier

Identifier of the owner (supplier) that created or manages this lookup entry

string format: uuid

""

ownerName

Name of the owner (supplier) that created this lookup entry

string

""

cityName

Name of the closest city where this lookup entry is located

string

""

countryName

Country name where this lookup entry is located

string

""

subCountryName

State or province where this lookup entry is located

string

""

subSubCountryName

County or district where this lookup entry is located

string

""

countryCode

ISO 3166-1 alpha-2 country code

string

""

ownerType

Type of owner that created this lookup (TRAVELIKO for platform-managed entries, HOTEL for supplier-created entries)

string

""

Allowed values: TRAVELIKO HOTEL

languageCode

Language code for the lookup name (ISO 639-1 format)

string

""

sort

Platform-specific sort order (lower values sort first: CITY=1, ISLAND=2, HOTEL=3, others vary)

integer format: int32

""

origin

Whether this is the primary/original lookup entry for this resource (true) or a variant like an alternate language or name (false)

boolean

lowercaseName

Lowercase version of the name, used for regex-based search operations

string

""

location

required

Geo-location

object

x

number format: double

y

number format: double

type

string

coordinates

Array<number>

key

additional properties

""

Example

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"
  }
}

object

type

string format: uri

title

string

status

integer format: int32

detail

string

instance

string format: uri

properties

object

key

additional properties

object

type

string format: uri

title

string

status

integer format: int32

detail

string

instance

string format: uri

properties

object

key

additional properties

object

type

string format: uri

title

string

status

integer format: int32

detail

string

instance

string format: uri

properties

object

key

additional properties

object

type

string format: uri

title

string

status

integer format: int32

detail

string

instance

string format: uri

properties

object

key

additional properties

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

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

Lookup entry not found for the given URL name and type

Media type application/json

object

identifier

Unique lookup identifier

string format: uuid

""

type

Type of lookup (CITY, HOTEL, ACTIVITY, SPA, RESTAURANT, ATTRACTION, ISLAND, COUNTRY, PLACE, MEETING_ROOM)

string

""

Allowed values: CITY ISLAND HOTEL SPA MEETING_ROOM RESTAURANT ATTRACTION ACTIVITY PLACE COUNTRY

typeIdentifier

Unique identifier for the lookup type resource (e.g., hotel ID, city geoname ID)

string format: uuid

""

name

Human-readable name of the lookup entry

string

""

urlName

URL-friendly slug that uniquely identifies this lookup within its type and location

string

""

ownerIdentifier

Identifier of the owner (supplier) that created or manages this lookup entry

string format: uuid

""

ownerName

Name of the owner (supplier) that created this lookup entry

string

""

cityName

Name of the closest city where this lookup entry is located

string

""

countryName

Country name where this lookup entry is located

string

""

subCountryName

State or province where this lookup entry is located

string

""

subSubCountryName

County or district where this lookup entry is located

string

""

countryCode

ISO 3166-1 alpha-2 country code

string

""

ownerType

Type of owner that created this lookup (TRAVELIKO for platform-managed entries, HOTEL for supplier-created entries)

string

""

Allowed values: TRAVELIKO HOTEL

languageCode

Language code for the lookup name (ISO 639-1 format)

string

""

sort

Platform-specific sort order (lower values sort first: CITY=1, ISLAND=2, HOTEL=3, others vary)

integer format: int32

""

origin

Whether this is the primary/original lookup entry for this resource (true) or a variant like an alternate language or name (false)

boolean

lowercaseName

Lowercase version of the name, used for regex-based search operations

string

""

location

required

Geo-location

object

x

number format: double

y

number format: double

type

string

coordinates

Array<number>

Example

{
  "identifier": "",
  "type": "CITY",
  "typeIdentifier": "",
  "name": "",
  "urlName": "",
  "ownerIdentifier": "",
  "ownerName": "",
  "cityName": "",
  "countryName": "",
  "subCountryName": "",
  "subSubCountryName": "",
  "countryCode": "",
  "ownerType": "TRAVELIKO",
  "languageCode": "",
  "sort": "",
  "origin": false,
  "lowercaseName": "",
  "location": ""
}

500

Internal Server Error

object

Example ^generated

{}

object

object

object

object