Skip to content
Wink

Show markers

GET
/api/managing-entity/{managingEntityIdentifier}/studio/map/markers/{listType}/{listIdentifier}
 
curl --request GET \
  --url 'https://api.wink.travel/api/managing-entity/d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69/studio/map/markers/LIST/9b7e4c3a-1f6d-4e8a-b2f9-5d3c0a8e7b61?displayCurrency=USD' \
  --header 'Authorization: Bearer <token>' \
  --header 'Wink-Version: 2.0'

Retrieve all inventory markers for a curated list or dynamic search, priced in the requested currency.

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
managingEntityIdentifier
required
string
""

UUID of the managing entity that owns the list.

Example 
d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69
listIdentifier
required
string
""

UUID of the curated list or dynamic search.

Example 
9b7e4c3a-1f6d-4e8a-b2f9-5d3c0a8e7b61
listType
required
string
""

Type of list: LIST (curated) or SEARCH (dynamic filter).

Example 
LIST

Query Parameters

Section titled “Query Parameters ”
displayCurrency
string
""

ISO 4217 currency code for pricing display.

Example 
USD

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 ”

Inventory markers for the specified curated list or dynamic search

Media type application/json
Array<object>

Represents a single inventory item displayed as a marker on a map

object
channelInventoryIdentifier

Unique identifier of the channel inventory or list item represented by this marker

string format: uuid
""
point

Geographic location coordinates as a GeoJSON Point (longitude, latitude)

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

UUID of the supplier (hotel or property) owning this inventory

string format: uuid
""
supplierName

Display name of the supplier property

string
""
inventoryIdentifier

UUID of the specific inventory item (e.g., room type or add-on)

string format: uuid
""
inventoryType

Classification of the inventory (e.g., GUEST_ROOM, ADD_ON, RESTAURANT, ACTIVITY)

string
""
Allowed values: GUEST_ROOM ADD_ON MEETING_ROOM RESTAURANT SPA ATTRACTION PLACE ACTIVITY
inventoryName

Human-friendly name of the inventory item

string
""
lowestDisplayPrice

Lowest available price for this inventory in the user’s requested currency

object
amount
required

Monetary amount value

number
""
currency
required

ISO 4217 currency code

string
"" >= 1 characters /^[A-Z]{3}$/
Example 
[
  {
    "channelInventoryIdentifier": "7a0c5d9e-2f6b-4c1a-8e4d-3b9f1a0c6d52",
    "point": {
      "type": "Point",
      "coordinates": [
        100.5581533,
        13.7370197
      ]
    },
    "supplierIdentifier": "e2c7b4d3-1a8f-4e9c-b5d6-3a9f0e7c2b18",
    "supplierName": "The Siam Residences",
    "inventoryIdentifier": "8b1d6e0f-3a7c-4d2b-9e5a-1c8f0b4d6e29",
    "inventoryType": "GUEST_ROOM",
    "inventoryName": "Deluxe Ocean View Suite",
    "lowestDisplayPrice": {
      "amount": 4500,
      "currency": "THB"
    }
  }
]

400

Section titled “400 ”

Bad Request — missing or invalid request parameter or body

Media type application/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 type application/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 type application/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 type application/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 type application/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 type application/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 type application/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 type application/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