Skip to content
Wink

Get lookup by URL name

GET
/api/public/{managingEntityIdentifier}/lookup/{urlName}
 
curl --request GET \
  --url 'https://api.wink.travel/api/public/d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69/lookup/bangkok-thailand?type=CITY' \
  --header 'Authorization: Bearer <token>' \
  --header 'Wink-Version: 2.0'

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

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
managingEntityIdentifier
required
string
""

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

Example 
d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69
urlName
required
string
""

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

Example 
bangkok-thailand

Query Parameters

Section titled “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

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

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Lookup entry found with full details including geolocation

Media type application/json

Lightweight representation of a lookup entry used for search auto-complete and inventory discovery

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 
{
  "identifier": "b7e4c1a2-3f5d-4e8a-9c21-6f0b5d8e3a47",
  "type": "HOTEL",
  "typeIdentifier": "a1f3c9d2-7e4b-4a0c-8d5e-2b9f1a6c3e78",
  "name": "The Siam Residences",
  "urlName": "the-siam-residences-bangkok-thailand",
  "ownerIdentifier": "a1f3c9d2-7e4b-4a0c-8d5e-2b9f1a6c3e78",
  "ownerName": "The Siam Residences",
  "cityName": "Bangkok",
  "countryName": "Thailand",
  "subCountryName": "Bangkok",
  "subSubCountryName": "Khlong San District",
  "countryCode": "TH",
  "ownerType": "HOTEL",
  "text": "b7e4c1a2-3f5d-4e8a-9c21-6f0b5d8e3a47",
  "languageCode": "en",
  "sort": 3,
  "origin": true,
  "lowercaseName": "the siam residences",
  "location": {
    "type": "Point",
    "coordinates": [
      100.5581533,
      13.7370197
    ]
  }
}

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