List activity feed events
GET/v2/activities
Requires your API key in the X-API-Key header.
Returns activity events visible to the caller, newest first. Intended for polling: pass since with the occurredAt of the last event you've already seen to fetch only what's new.
Scoping
You only see events for resources you already have access to elsewhere in the API. There is no way to see another partner's activity.
Filtering
category and actor each accept a comma-separated list restricted to the values below; an unrecognized value is a 400 naming the offending entry.
curl "https://api.turneo.co/v2/activities" \
-H "X-API-Key: <your-api-key>"Query parameters
sincestring (date-time)ISO 8601 datetime. Only events with
occurredAtstrictly after this instant are returned. Naive datetimes (no timezone offset) are interpreted as UTC. An unparsable value is a 400.- Example:
2026-07-01T12:00:00Z
categorystringComma-separated list of categories to include. One of
booking,experience,review,retail.- Example:
booking,review
actorstringComma-separated list of actor types to include. One of
guest,concierge,organizer,turneo_ai.- Example:
guest,concierge
booking_idstring (uuid)Only events for this booking — powers the booking sidebar's per-booking history. Composes with the caller's scope (it can never widen visibility). A non-UUID value is a 400. Events written before this field existed are not matched.
- Example:
0b7f5f7e-1234-4c56-89ab-4d5e6f7a8b9c
pageintegerPage number (1-based).
- Example:
1
page_sizeintegerItems per page (default 50). Note the snake_case wire name — query parameters are not camelCased.
- Example:
50
nopaginationbooleanWhen
true, disables pagination and returns the bare array of results.- Example:
false
Responses
200object
Returns the caller's scoped activity feed.
countintegerTotal number of matching events across all pages.
- Example:
128
nextstringnullableURL of the next page, or null if this is the last page.
- Example:
https://api.turneo.co/v2/activities?page=2&page_size=50
previousstringnullableURL of the previous page, or null if this is the first page.
resultsobject[]Child fields
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
{
"count": 128,
"next": "https://api.turneo.co/v2/activities?page=2&page_size=50",
"previous": null,
"results": [
{
"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
- 400
Validation failed. Inspect
errors[].fieldanderrors[].code.- 401
Missing or invalid
X-API-Keyheader.
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."
}
]
}