List

GET

/api/managing-entity/{managingEntityIdentifier}/studio/dynamic-list

const url = 'https://api.wink.travel/api/managing-entity/d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69/studio/dynamic-list';
const options = {
  method: 'GET',
  headers: {'Wink-Version': '2.0', Authorization: 'Bearer <token>'}
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

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

oauth2ClientCredentials

Parameters

Path Parameters

managingEntityIdentifier

required

string

List searches owned by this managing entity.

Example

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

Header Parameters

Wink-Version

string

default: 2.0.0

Allowed values: 2.0

Responses

200

List of saved searches for the managing entity.

application/json

Array<object>

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

object

aggregateReviewRating

Filter on aggregate review score the hotel has

integer format: int32

architecturalStyles

Supported OTA specification ARC code. See OTA geoname data

Array<string>

cities

City filter

Array<string>

continents

Continent filter

Array<string>

countries

Country filter

Array<string>

createdDate

Datetime this record was first created

string | null format: date-time

hotelCategories

Supported OTA specification PCT code. See OTA geoname data

Array<string>

hotelStars

Filter on number of stars the hotel has.

integer format: int32

Unique identifier for this record.

string format: uuid

inventoryName

Regex expression filter matching on inventory name

string

inventoryTypes

Filter on inventory types

Array<string>

Allowed values: GUEST_ROOM ADD_ON MEETING_ROOM RESTAURANT SPA ATTRACTION PLACE ACTIVITY

lastUpdate

Datetime this record was last updated

string | null format: date-time

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

locationCategories

Supported OTA specification LOC code. See OTA geoname data

Array<string>

name

required

Name of dynamic list for when user want to persist it

string

"" >= 1 characters

nearPoint

Find hotels close to certain location

object

coordinates

Array<number>

type

string

number format: double

ownerIdentifier

required

Entity identifier of record creator

string format: uuid

"" >= 1 characters

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

propertyName

Regex expression filter matching on property name.

string

radiusInMeters

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

integer format: int64

segmentCategories

Supported OTA specification SEG code. See OTA geoname data

Array<string>

showChildFriendly

Filter on child-friendly hotels

boolean

showDirectOnly

Filter on direct inventory

boolean

showEcoFriendly

Filter on eco-friendly hotels

boolean

showPetFriendly

Filter on pet-friendly hotels

boolean

showPopular

Filter on hotel that has had a certain amount of bookings

boolean

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

Example

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

400

Bad Request — missing or invalid request parameter or body

application/problem+json

object

detail

string

instance

string format: uri

properties

object

key

additional properties

status

integer format: int32

title

string

type

string format: uri

key

additional properties

Example

401

Unauthorized — authentication is required or the session has expired

application/problem+json

object

detail

string

instance

string format: uri

properties

object

key

additional properties

status

integer format: int32

title

string

type

string format: uri

key

additional properties

Example

403

Forbidden — authenticated but lacking the required permission or scope

application/problem+json

object

detail

string

instance

string format: uri

properties

object

key

additional properties

status

integer format: int32

title

string

type

string format: uri

key

additional properties

Example

404

Not Found — the requested resource does not exist

application/problem+json

object

detail

string

instance

string format: uri

properties

object

key

additional properties

status

integer format: int32

title

string

type

string format: uri

key

additional properties

Example

405

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

application/problem+json

object

detail

string

instance

string format: uri

properties

object

key

additional properties

status

integer format: int32

title

string

type

string format: uri

key

additional properties

Example

409

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

application/problem+json

object

detail

string

instance

string format: uri

properties

object

key

additional properties

status

integer format: int32

title

string

type

string format: uri

key

additional properties

Example

415

Unsupported Media Type — use application/json

application/problem+json

object

detail

string

instance

string format: uri

properties

object

key

additional properties

status

integer format: int32

title

string

type

string format: uri

key

additional properties

Example

500

Internal Server Error — an unexpected failure occurred on the server

application/problem+json

object

detail

string

instance

string format: uri

properties

object

key

additional properties

status

integer format: int32

title

string

type

string format: uri

key

additional properties

Example

503

Service Unavailable — a downstream dependency is unreachable

application/problem+json

object

detail

string

instance

string format: uri

properties

object

key

additional properties

status

integer format: int32

title

string

type

string format: uri

key

additional properties