Retrieve a single activity event
GET/v2/activities/{activityId}
Requires your API key in the X-API-Key header.
Returns a single activity event by id. Subject to the same scoping as the list endpoint — requesting an event outside the caller's scope returns 404 rather than 403, to avoid revealing that the event exists.
curl "https://api.turneo.co/v2/activities/7a1e74c3-d0f2-41e6-ac12-33108100200e" \
-H "X-API-Key: <your-api-key>"Path parameters
activityIdstring (uuid)requiredThe unique identifier of the activity event.
- Example:
7a1e74c3-d0f2-41e6-ac12-33108100200e
Responses
200object
Returns the requested activity event.
idstring (uuid)Unique identifier of the event.
- Example:
7a1e74c3-d0f2-41e6-ac12-33108100200e
typestringThe specific event type. One of
booking.created,booking.confirmed,booking.cancelled,booking.rejected,booking.payment_link_created,review.submitted,experience.published,experience.updated,retail.purchased,retail.cancelled.- Example:
booking.confirmed
categorystringCoarse grouping used for filtering. Derived from
type.- Allowed values:
bookingexperiencereviewretail- Example:
booking
occurredAtstring (date-time)When the underlying event happened (not when the row was written).
- Example:
2026-07-01T14:32:00Z
payloadobjectA self-contained snapshot of the event, shaped differently per
type(e.g. abooking.confirmedpayload embeds the booking/experience summary at confirmation time). Renders independently of the current state of the source booking/experience/review.actorTypestringWho triggered the event.
- Allowed values:
guestconciergeorganizerturneo_aisystem- Example:
guest
actorIdstringnullableIdentifier of the actor, when applicable (e.g. the guest or partner id). Null for
system-triggered events.- Example:
3f2e6d1c-8a4b-4f0e-9c7d-2b1a0e9f8d7c
{
"id": "7a1e74c3-d0f2-41e6-ac12-33108100200e",
"type": "booking.confirmed",
"category": "booking",
"occurredAt": "2026-07-01T14:32:00Z",
"payload": {},
"actorType": "guest",
"actorId": "3f2e6d1c-8a4b-4f0e-9c7d-2b1a0e9f8d7c"
}Errors
- 401
Missing or invalid
X-API-Keyheader.- 404
The resource does not exist or belongs to another partner (existence is not leaked across partners).
Error body
typestringError class.
- Allowed values:
validation_errorclient_errorserver_error- Example:
validation_error
errorsobject[]Child fields
codestringMachine-readable error code.
- Example:
required
fieldstringnullableOffending field, or null/'general' for non-field errors.
- Example:
startTime
messagestringHuman-readable message.
- Example:
This field is required.
{
"type": "validation_error",
"errors": [
{
"code": "required",
"field": "startTime",
"message": "This field is required."
}
]
}