Get markers for a list

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'

• Endpoint

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

Authorizations

• oauth2ClientCredentials

Parameters

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

displayCurrency

string

""

ISO 4217 currency code for pricing display.

Example

USD

Header Parameters

Wink-Version

string

default: 2.0.0

Allowed values: 2.0

Responses

200

OK

Media type application/json

Array<object>

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

object

channelInventoryIdentifier

required

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

string format: uuid

""

point

required

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

object

x

number format: double

y

number format: double

type

string

coordinates

Array<number>

supplierIdentifier

required

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

string format: uuid

""

supplierName

required

Display name of the supplier property

string

""

inventoryIdentifier

required

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

string format: uuid

""

inventoryType

required

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

required

Human-friendly name of the inventory item

string

""

lowestDisplayPrice

required

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

object

amount

required

number

currency

required

string

>= 1 characters

Example

[
  null
]

400

Bad Request

object

type

string format: uri

title

string

status

integer format: int32

detail

string

instance

string format: uri

properties

object

key

additional properties

Example ^generated

{
  "type": "https://example.com",
  "title": "example",
  "status": 1,
  "detail": "example",
  "instance": "https://example.com",
  "properties": {
    "additionalProperty": "example"
  }
}

object

type

string format: uri

title

string

status

integer format: int32

detail

string

instance

string format: uri

properties

object

key

additional properties

object

type

string format: uri

title

string

status

integer format: int32

detail

string

instance

string format: uri

properties

object

key

additional properties

object

type

string format: uri

title

string

status

integer format: int32

detail

string

instance

string format: uri

properties

object

key

additional properties

object

type

string format: uri

title

string

status

integer format: int32

detail

string

instance

string format: uri

properties

object

key

additional properties

401

Unauthorized

Media type */*

object

type

string format: uri

title

string

status

integer format: int32

detail

string

instance

string format: uri

properties

object

key

additional properties

403

Forbidden

Media type */*

object

type

string format: uri

title

string

status

integer format: int32

detail

string

instance

string format: uri

properties

object

key

additional properties

500

Internal Server Error

object

Example ^generated

{}

object

object

object

object