Skip to content
campaiDeveloper
campai.com

Booking · Events

POST/{organizationId}/{mandateId}/booking/events/{eventId}/history/listReads only

List event history

Lists an event's change history, including changes to its information, schedule, place and booking settings. It takes an organization ID, mandate ID and event ID, with optional limit and offset values. It returns history items newest first; the limit defaults to 20 and can be from 1 to 50, and the offset defaults to 0.

Permissions

Send an API key of the organization in the path, using the X-API-Key header.

Who may call it

  • Callers must have organization access.
  • Callers need mandate.read and event.read before the handler runs.
  • When organization access is not null, user.read affects whether non-contact actors other than the current actor are masked. It also affects the user details attached to a contact actor.
  • When organization access is not null, API actors are masked without apiKey.read.
  • Legacy contact.read also permits contact actor details to be shown.

Request

Path parameters

  • organizationIdidrequired
  • mandateIdidrequired
  • eventIdidrequired

Body

Content-Type: application/json

  • limitinteger

    1–50 · default 20

  • offsetinteger

    at least 0 · default 0

Request
curl --fail-with-body --silent --show-error --max-time 30 --globoff \
  --request POST 'https://cloud.campai.com/api/YOUR_ORGANIZATION_ID/YOUR_MANDATE_ID/booking/events/YOUR_EVENT_ID/history/list' \
  --header 'X-API-Key: YOUR_API_KEY'

No request that worked has been recorded yet, so the body is not shown.

Response

200 Successful response

Content-Type: application/json

A list of object.

  • _idid
  • timestampstring · date-time
  • actorobject

    The actor's details may be masked when the caller lacks the relevant read permissions.

  • reviewedByobjectnullable

    The reviewer's details may be masked when the caller lacks the relevant read permissions.

  • actionstring
    created updated added removed deleted
  • groupsobject[]
    2 properties
    • pathstring
    • propertiesobject[]
      3 properties
      • pathstring
      • fromany
      • toany
Response200
[
  {
    "_id": "000000000000000000000001",
    "timestamp": "2026-06-15T22:30:00Z",
    "actor": {
      "name": "string",
      "type": "user",
      "userId": "string",
      "image": {
        "resource": "string"
      }
    },
    "reviewedBy": {
      "name": "string",
      "type": "user",
      "userId": "string",
      "image": {
        "resource": "string"
      }
    },
    "action": "created"
  }
]

Errors

Other errors

StatusErrorWhen
404Event was not foundIf the event is not found in the requested organization and mandate scope, the endpoint returns HTTP 404 with key routes.booking.events.noEvent.

Errors nearly every request can meet are listed under Errors.