Show
const url = 'https://api.wink.travel/api/managing-entity/d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69/studio/grids/3c6b1a5d-8e2f-4a0b-9c7d-6e4f0a8b2c51';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/grids/3c6b1a5d-8e2f-4a0b-9c7d-6e4f0a8b2c51 \ --header 'Authorization: Bearer <token>' \ --header 'Wink-Version: 2.0'Retrieves a single curated or saved-search grid by its identifier, scoped to the owning managing entity; returns 404 if not found.
Authorizations
Section titled “Authorizations ”Parameters
Section titled “ Parameters ”Path Parameters
Section titled “Path Parameters ”Managing entity identifier that owns the grid.
Example
d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69Grid identifier to retrieve.
Example
3c6b1a5d-8e2f-4a0b-9c7d-6e4f0a8b2c51Header Parameters
Section titled “Header Parameters ”Responses
Section titled “ Responses ”The curated or saved-search grid matching the given identifier.
Persisted sellable list configuration that groups inventory items for display as a curated grid or collection on a seller’s web component
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.
Managing entity (account owner) identifier
Descriptive name of this grid for seller use only
Customization configuration identifier
Contains localized title and description of grid (at least one entry in English required)
Foundation class for storing multi-language content (names and descriptions) with content change detection throughout the Wink Platform.
object
Use as title or short text description
Longer text description
Indicate which language this description is written in.
Whether it was user or system generated.
The md5 hash of the name, description and language.
Keywords and metadata tags for the grid used for SEO and filtering purposes
Current status of the grid (ACTIVE, INACTIVE, ARCHIVED)
List type
Inventory record identifier for the curated list, saved search, or channel (format varies by listType)
Generate an animated GIF from multiple images instead of a static grid (requires at least 2 images)
Delay between animation frames in milliseconds; -1 disables animation
Badge type and sort order for display on the web component (MEMBER, BEST_VALUE, TOP_RATED, etc.)
Indicate which initial values to display first on the front-facing card
Example
{ "id": "3c6b1a5d-8e2f-4a0b-9c7d-6e4f0a8b2c51", "createdDate": "2026-01-14T09:30:00", "lastUpdate": "2026-01-15T09:30:00", "version": 1, "ownerIdentifier": "d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69", "name": "Luxury Bangkok Properties", "customizationIdentifier": "3c6b1a5d-8e2f-4a0b-9c7d-6e4f0a8b2c51", "descriptions": [], "keywords": [ "bangkok", "luxury" ], "status": "ACTIVE", "listType": "LIST", "listIdentifier": "e2c7b4d3-1a8f-4e9c-b5d6-3a9f0e7c2b18", "animate": false, "animateDelay": -1, "sort": "MEMBER", "displayType": "NATIVE"}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