Search destinations

GET

/api/public/{managingEntityIdentifier}/search

curl --request GET \
  --url 'https://api.wink.travel/api/public//search?term=Bangkok' \
  --header 'Authorization: Bearer <token>' \
  --header 'Wink-Version: 2.0'

• Endpoint

Returns matching hotels, cities, countries, and attractions for the given search term, filtered by the managing entity. Supports partial matching and case-insensitive search across all lookup types.

Authorizations

• oauth2ClientCredentials

Parameters

Path Parameters

managingEntityIdentifier

required

string

""

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

Query Parameters

term

required

string

""

Search term (e.g., city, hotel name, activity name). Supports partial matching.

Example

Bangkok

Header Parameters

Wink-Version

string

default: 2.0.0

Allowed values: 2.0

Responses

200

List of matching lookup entries (may be empty if no matches)

Media type application/json

Array<object>

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

""

locationX

Longitude coordinate of the lookup entry location

number format: double

""

locationY

Latitude coordinate of the lookup entry location

number format: double

""

location

GeoJson location

object

x

number format: double

y

number format: double

type

string

coordinates

Array<number>

Example

[
  ""
]

400

Missing or empty search term

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

500

Internal Server Error

object

Example ^generated

{}

object

object

object

object