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.

Requestbash
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 occurredAt strictly 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
  • categorystring

    Comma-separated list of categories to include. One of booking, experience, review, retail.

    Example:
    booking,review
  • actorstring

    Comma-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
  • pageinteger

    Page number (1-based).

    Example:
    1
  • page_sizeinteger

    Items per page (default 50). Note the snake_case wire name — query parameters are not camelCased.

    Example:
    50
  • nopaginationboolean

    When true, disables pagination and returns the bare array of results.

    Example:
    false

Responses

200object

Returns the caller's scoped activity feed.

  • countinteger

    Total number of matching events across all pages.

    Example:
    128
  • nextstringnullable

    URL of the next page, or null if this is the last page.

    Example:
    https://api.turneo.co/v2/activities?page=2&page_size=50
  • previousstringnullable

    URL 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
    • typestring

      The 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
    • categorystring

      Coarse 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
    • payloadobject

      A self-contained snapshot of the event, shaped differently per type (e.g. a booking.confirmed payload embeds the booking/experience summary at confirmation time). Renders independently of the current state of the source booking/experience/review.

    • actorTypestring

      Who triggered the event.

      Allowed values:
      guestconciergeorganizerturneo_aisystem
      Example:
      guest
    • actorIdstringnullable

      Identifier of the actor, when applicable (e.g. the guest or partner id). Null for system-triggered events.

      Example:
      3f2e6d1c-8a4b-4f0e-9c7d-2b1a0e9f8d7c
Response 200json
{
  "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[].field and errors[].code.

401

Missing or invalid X-API-Key header.

Error body
  • typestring

    Error class.

    Allowed values:
    validation_errorclient_errorserver_error
    Example:
    validation_error
  • errorsobject[]
    Child fields
    • codestring

      Machine-readable error code.

      Example:
      required
    • fieldstringnullable

      Offending field, or null/'general' for non-field errors.

      Example:
      startTime
    • messagestring

      Human-readable message.

      Example:
      This field is required.
Response 400json
{
  "type": "validation_error",
  "errors": [
    {
      "code": "required",
      "field": "startTime",
      "message": "This field is required."
    }
  ]
}