Skip to content
Wink

Show for account

GET
/api/managing-entity/{managingEntityIdentifier}/message/list
 
curl --request GET \
  --url https://api.wink.travel/api/managing-entity/d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69/message/list \
  --header 'Authorization: Bearer <token>' \
  --header 'Wink-Version: 2.0'

List the notifications addressed to a given managing entity, newest first.

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Path Parameters

Section titled “Path Parameters ”
managingEntityIdentifier
required
string
""

Show all messages for this managing entity

Example 
d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69

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 ”

Notifications retrieved successfully

Media type application/json
Array<object>

A notification message delivered to a user or managing entity within the Wink platform

object
id

Document UUID

string format: uuid
""
createdDate

Datetime this record was first created

string format: date-time
""
lastUpdate

Datetime this record was last updated

string format: date-time
""
version

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.

integer format: int64
""
userIdentifier
required

Owner identifier

string format: uuid
"" >= 1 characters
managingEntityIdentifier

ManagingEntity identifier

string format: uuid
""
name

Owner name

string
""
priority
required

Importance of message

string
""
Allowed values: HIGH MEDIUM LOW
type
required

Message type

string
""
Allowed values: ALERT MESSAGE FEATURE
recipientType
required

Recipient type

string
""
Allowed values: USER ACCOUNT
messageTemplateId
required

Message template

string
"" >= 1 characters
subject
required

Subject of message

string
"" >= 1 characters
body
required

Body of message

string
"" >= 1 characters
ctaUrl

Path to feature

string format: uri
""
read

AffiliateAccount read announcement

boolean
markedAsRemoved

Message marked as removed

boolean
notifyViaEmail

Also send email announcement

boolean
Example 
[
  {
    "id": "3c6b1a5d-8e2f-4a0b-9c7d-6e4f0a8b2c51",
    "createdDate": "2026-01-14T09:30:00",
    "lastUpdate": "2026-01-14T09:30:00",
    "version": 0,
    "userIdentifier": "d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69",
    "managingEntityIdentifier": "d5b8a3c2-9e6f-4a1b-8d34-7c2e1f0a5b69",
    "name": "The Siam Residences, Bangkok",
    "priority": "MEDIUM",
    "type": "MESSAGE",
    "recipientType": "ACCOUNT",
    "messageTemplateId": "welcome-email-2024",
    "subject": "Your Booking Confirmation",
    "body": "Your booking at The Siam Residences for January 14-16, 2026 has been confirmed.",
    "ctaUrl": "https://app.wink.travel/bookings/WNK4ZQ7P",
    "read": false,
    "markedAsRemoved": false,
    "notifyViaEmail": false
  }
]

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