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
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”List searches owned by this managing entity.
Example
d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69Header Parameters
Section titled “Header Parameters”Responses
Section titled “Responses”List of saved searches for the managing entity.
Lightweight projection of a saved dynamic inventory search, including all filter criteria and sort preferences.
object
Filter on aggregate review score the hotel has
Supported OTA specification ARC code. See OTA geoname data
City filter
Continent filter
Country filter
Datetime this record was first created
Supported OTA specification PCT code. See OTA geoname data
Filter on number of stars the hotel has.
Unique identifier for this record.
Regex expression filter matching on inventory name
Filter on inventory types
Datetime this record was last updated
Filter on lifestyles
Supported OTA specification LOC code. See OTA geoname data
Name of dynamic list for when user want to persist it
Find hotels close to certain location
object
Entity identifier of record creator
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
Regex expression filter matching on property name.
Use this in conjunction with nearPoint. Control the distance from point we are searching for.
Supported OTA specification SEG code. See OTA geoname data
Filter on child-friendly hotels
Filter on direct inventory
Filter on eco-friendly hotels
Filter on pet-friendly hotels
Filter on hotel that has had a certain amount of bookings
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.
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 }]Bad Request — missing or invalid request parameter or body
object
object
Examplegenerated
{ "detail": "example", "instance": "https://example.com", "properties": { "additionalProperty": "example" }, "status": 1, "title": "example", "type": "https://example.com"}Unauthorized — authentication is required or the session has expired
object
object
Examplegenerated
{ "detail": "example", "instance": "https://example.com", "properties": { "additionalProperty": "example" }, "status": 1, "title": "example", "type": "https://example.com"}Forbidden — authenticated but lacking the required permission or scope
object
object
Examplegenerated
{ "detail": "example", "instance": "https://example.com", "properties": { "additionalProperty": "example" }, "status": 1, "title": "example", "type": "https://example.com"}Not Found — the requested resource does not exist
object
object
Examplegenerated
{ "detail": "example", "instance": "https://example.com", "properties": { "additionalProperty": "example" }, "status": 1, "title": "example", "type": "https://example.com"}Method Not Allowed — the HTTP verb is not supported on this endpoint
object
object
Examplegenerated
{ "detail": "example", "instance": "https://example.com", "properties": { "additionalProperty": "example" }, "status": 1, "title": "example", "type": "https://example.com"}Conflict — the resource was modified by someone else since you read it; re-read it and retry with the new version
object
object
Examplegenerated
{ "detail": "example", "instance": "https://example.com", "properties": { "additionalProperty": "example" }, "status": 1, "title": "example", "type": "https://example.com"}Unsupported Media Type — use application/json
object
object
Examplegenerated
{ "detail": "example", "instance": "https://example.com", "properties": { "additionalProperty": "example" }, "status": 1, "title": "example", "type": "https://example.com"}Internal Server Error — an unexpected failure occurred on the server
object
object
Examplegenerated
{ "detail": "example", "instance": "https://example.com", "properties": { "additionalProperty": "example" }, "status": 1, "title": "example", "type": "https://example.com"}Service Unavailable — a downstream dependency is unreachable
object
object
Examplegenerated
{ "detail": "example", "instance": "https://example.com", "properties": { "additionalProperty": "example" }, "status": 1, "title": "example", "type": "https://example.com"}