Skip to content
Wink

Get a single marker

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

Retrieve the map marker for a specific channel inventory item.

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 inventory.

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

UUID of the channel inventory item to display as a marker.

Example 
9b7e4c3a-1f6d-4e8a-b2f9-5d3c0a8e7b61

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 ”

OK

Media type application/json

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

Section titled “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"
  }
}

401

Section titled “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

Section titled “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

Section titled “500 ”

Internal Server Error

object
Example generated
{}