Create
const url = 'https://api.wink.travel/api/managing-entity/d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69/studio/dynamic-list';const options = { method: 'POST', headers: { 'Wink-Version': '2.0', Authorization: 'Bearer <token>', 'Content-Type': 'application/json' }, body: 'null'};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request POST \ --url https://api.wink.travel/api/managing-entity/d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69/studio/dynamic-list \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --header 'Wink-Version: 2.0' \ --data nullCreates a new saved search whose filters resolve to a live list of suppliers/inventory when queried.
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters ”Create search owned by this managing entity.
Example
d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69Header Parameters
Section titled “Header Parameters ”Request Body required
Section titled “Request Body required ”Dynamic list definition including filter criteria, sorting rules and display settings
Request payload to create or update a dynamic inventory search list with filter criteria and sort preferences.
object
Name of dynamic list for when user want to persist it
Example
Bangkok Luxury HotelsRegex expression filter matching on property name.
Example
The SiamRegex expression filter matching on inventory name
Example
Deluxe SuiteContinent filter
Country filter
City filter
Filter on eco-friendly hotels
Example
falseFilter on pet-friendly hotels
Example
falseFilter on child-friendly hotels
Example
falseFilter on hotel that has had a certain amount of bookings
Example
falseFilter on direct inventory
Example
falseFilter on lifestyles
Example
LIFESTYLE_RELAXFilter on number of stars the hotel has.
Example
5Filter on aggregate review score the hotel has
Example
8Find hotels close to certain location
object
Use this in conjunction with nearPoint. Control the distance from point we are searching for.
Example
5000Filter on inventory types
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
Example
4Example
{ "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"}Responses
Section titled “ Responses ”Saved search created successfully.
A saved dynamic inventory search with configurable filter criteria and sort order, owned by a managing entity.
object
Document UUID
Datetime this record was first created
Datetime this record was last updated
Version property that shows how many times this document has been persisted. Document will not persist if the version property is less than current version property in the system. Result in an optimistic locking exception.
Entity identifier of record creator
Name of dynamic list for when user want to persist it
Regex expression filter matching on property name.
Supported OTA specification LOC code. See OTA geoname data
Supported OTA specification SEG code. See OTA geoname data
Supported OTA specification PCT code. See OTA geoname data
Supported OTA specification ARC code. See OTA geoname data
Regex expression filter matching on inventory name
Continent filter
Country filter
City filter
Filter on eco-friendly hotels
Filter on pet-friendly hotels
Filter on child-friendly hotels
Filter on hotel that has had a certain amount of bookings
Filter on direct inventory
Filter on lifestyles
Filter on number of stars the hotel has.
Filter on aggregate review score the hotel has
Find hotels close to certain location
object
Use this in conjunction with nearPoint. Control the distance from point we are searching for.
Filter on inventory types
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
Example
Bad Request — missing or invalid request parameter or body
object
object
Example
Unauthorized — authentication is required or the session has expired
object
object
Example
Forbidden — authenticated but lacking the required permission or scope
object
object
Example
Not Found — the requested resource does not exist
object
object
Example
Method Not Allowed — the HTTP verb is not supported on this endpoint
object
object
Example
Unsupported Media Type — use application/json
object
object
Example
Internal Server Error — an unexpected failure occurred on the server
object
object
Example
Service Unavailable — a downstream dependency is unreachable