Skip to content
Wink

List

GET
/api/managing-entity/{managingEntityIdentifier}/studio/dynamic-list
curl --request GET \
  --url https://api.wink.travel/api/managing-entity/d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69/studio/dynamic-list \
  --header 'Authorization: Bearer <token>' \
  --header 'Wink-Version: 2.0'

Returns every saved search owned by the managing entity.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
managingEntityIdentifier
required
string
""

List searches owned by this managing entity.

Example
d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69

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”

List of saved searches for the managing entity.

Media typeapplication/json
Array<object>

Lightweight projection of a saved dynamic inventory search, including all filter criteria and sort preferences.

object
id

Unique identifier for this record.

string format: uuid
""
createdDate

Datetime this record was first created

string | null format: date-time
""
lastUpdate

Datetime this record was last updated

string | null format: date-time
""
version

Optimistic-locking version. Echo this value back as an If-Match request header on a conditional update; the server responds 409 if the record changed in the meantime. Null when this projection has no backing versioned document, in which case no conditional update is possible.

integer | null format: int64
""
ownerIdentifier
required

Entity identifier of record creator

string format: uuid
"" >= 1 characters
name
required

Name of dynamic list for when user want to persist it

string
"" >= 1 characters
propertyName

Regex expression filter matching on property name.

string
""
locationCategories

Supported OTA specification LOC code. See OTA geoname data

Array<string>
""
segmentCategories

Supported OTA specification SEG code. See OTA geoname data

Array<string>
""
hotelCategories

Supported OTA specification PCT code. See OTA geoname data

Array<string>
""
architecturalStyles

Supported OTA specification ARC code. See OTA geoname data

Array<string>
""
inventoryName

Regex expression filter matching on inventory name

string
""
continents

Continent filter

Array<string>
countries

Country filter

Array<string>
cities

City filter

Array<string>
showEcoFriendly

Filter on eco-friendly hotels

boolean
showPetFriendly

Filter on pet-friendly hotels

boolean
showChildFriendly

Filter on child-friendly hotels

boolean
showPopular

Filter on hotel that has had a certain amount of bookings

boolean
showDirectOnly

Filter on direct inventory

boolean
lifestyles

Filter on lifestyles

Array<string>
""
Allowed values: LIFESTYLE_HEALTH_FITNESS LIFESTYLE_RELAX LIFESTYLE_ADULT_ONLY LIFESTYLE_ADVENTURE LIFESTYLE_BUSINESS LIFESTYLE_LGBT LIFESTYLE_SINGLE_PARENT LIFESTYLE_SOLO_FEMALE LIFESTYLE_BEAUTY LIFESTYLE_FOODIE LIFESTYLE_FAMILY LIFESTYLE_ROMANCE LIFESTYLE_COUPLE LIFESTYLE_SOLO LIFESTYLE_BACKPACKER LIFESTYLE_SHOPPING LIFESTYLE_SPORTS LIFESTYLE_MOUNTAIN LIFESTYLE_BEACH LIFESTYLE_CITY LIFESTYLE_COUNTRY LIFESTYLE_CULTURE LIFESTYLE_ECO
hotelStars

Filter on number of stars the hotel has.

integer format: int32
""
aggregateReviewRating

Filter on aggregate review score the hotel has

integer format: int32
""
nearPoint

Find hotels close to certain location

object
x
number format: double
y
number format: double
type
string
coordinates
Array<number>
radiusInMeters

Use this in conjunction with nearPoint. Control the distance from point we are searching for.

integer format: int64
0
inventoryTypes

Filter on inventory types

Array<string>
Allowed values: GUEST_ROOM ADD_ON MEETING_ROOM RESTAURANT SPA ATTRACTION PLACE ACTIVITY
primaryOrderBy

Control how you want the search results sorted. Options are:

  • 1: Inventory name
  • 2: Price: High to low
  • 3: Price: Low to high
  • 4: Commission: High to low
  • 5: Commission: Low to high
  • 6: Discount: High to low
  • 7: Discount: Low to high
string
""
Example
[
  {
    "id": "b7e4c1a2-3f5d-4e8a-9c21-6f0b5d8e3a47",
    "createdDate": "2026-01-14T09:30:00",
    "lastUpdate": "2026-02-03T16:45:12",
    "version": 3,
    "ownerIdentifier": "d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69",
    "name": "Bangkok Luxury Hotels",
    "propertyName": "The Siam",
    "locationCategories": 1701,
    "segmentCategories": 7,
    "hotelCategories": 1,
    "architecturalStyles": 50,
    "inventoryName": "Deluxe Suite",
    "continents": [
      "AS"
    ],
    "countries": [
      "1605651"
    ],
    "cities": [
      "1609350"
    ],
    "showEcoFriendly": false,
    "showPetFriendly": false,
    "showChildFriendly": false,
    "showPopular": false,
    "showDirectOnly": false,
    "lifestyles": "LIFESTYLE_RELAX",
    "hotelStars": 5,
    "aggregateReviewRating": 8,
    "radiusInMeters": 5000,
    "inventoryTypes": [
      "GUEST_ROOM"
    ],
    "primaryOrderBy": "4"
  }
]

400

Section titled “400”

Bad Request — missing or invalid request parameter or body

Media typeapplication/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 typeapplication/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 typeapplication/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 typeapplication/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 typeapplication/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

409

Section titled “409”

Conflict — the resource was modified by someone else since you read it; re-read it and retry with the new version

Media typeapplication/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 typeapplication/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 typeapplication/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 typeapplication/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