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.

Requestbash
curl "https://api.turneo.co/v2/activities/7a1e74c3-d0f2-41e6-ac12-33108100200e" \
  -H "X-API-Key: <your-api-key>"

Path parameters

  • activityIdstring (uuid)required

    The 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
  • 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
{
  "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-Key header.

404

The resource does not exist or belongs to another partner (existence is not leaked across partners).

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 401json
{
  "type": "validation_error",
  "errors": [
    {
      "code": "required",
      "field": "startTime",
      "message": "This field is required."
    }
  ]
}