Booking · Events
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.readandevent.readbefore the handler runs. - When organization access is not null,
user.readaffects 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.readalso permits contact actor details to be shown.
Request
Path parameters
-
organizationIdidrequired -
mandateIdidrequired -
eventIdidrequired
Body
Content-Type: application/json
-
limitinteger1–50 · default
20 -
offsetintegerat least 0 · default
0
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'const response = await fetch("https://cloud.campai.com/api/YOUR_ORGANIZATION_ID/YOUR_MANDATE_ID/booking/events/YOUR_EVENT_ID/history/list", {
method: "POST",
headers: {
"X-API-Key": "YOUR_API_KEY"
},
redirect: 'error',
signal: AbortSignal.timeout(30_000),
});
if (!response.ok) throw new Error(`campai HTTP ${response.status}`);
const text = await response.text();
const result = text ? JSON.parse(text) : null;
console.log(JSON.stringify(result, null, 2));<?php
$context = stream_context_create(['http' => [
'method' => 'POST',
'header' => [
'X-API-Key: YOUR_API_KEY',
],
'timeout' => 30,
'follow_location' => 0,
'ignore_errors' => true,
]]);
$text = @file_get_contents('https://cloud.campai.com/api/YOUR_ORGANIZATION_ID/YOUR_MANDATE_ID/booking/events/YOUR_EVENT_ID/history/list', false, $context);
preg_match('/^HTTP\/\S+ (\d{3})/', $http_response_header[0] ?? '', $match);
$status = (int) ($match[1] ?? 0);
if ($text === false || $status < 200 || $status >= 300) {
throw new RuntimeException("campai HTTP $status (0 means no response)");
}
$result = $text === '' ? null : json_decode($text, true, 512, JSON_THROW_ON_ERROR);
echo json_encode($result, JSON_PRETTY_PRINT | JSON_THROW_ON_ERROR), PHP_EOL;
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 -
actorobjectThe actor's details may be masked when the caller lacks the relevant read permissions.
-
reviewedByobjectnullableThe reviewer's details may be masked when the caller lacks the relevant read permissions.
-
actionstringcreatedupdatedaddedremoveddeleted -
groupsobject[]2 properties
-
pathstring -
propertiesobject[]3 properties
-
pathstring -
fromany -
toany
-
-
[
{
"_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
| Status | Error | When |
|---|---|---|
| 404 | Event was not found | If 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.