Skip to content
campaiDeveloper
campai.com

Booking · Bookings

POST/{organizationId}/{mandateId}/booking/bookings/{bookingId}/history/listReads only

List booking history

Lists the change history of a booking, including creation, buyer changes, cancellations and status changes. Supply the organization, mandate and booking IDs; results are ordered newest first. limit defaults to 20 and can be 1–50; 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

  • The caller must have access to the organization.
  • The caller needs mandate.read and booking.read.
  • user.read affects whether non-contact actors other than the current actor are visible. It also affects the name and image of a contact's associated user when that user is not the current actor.
  • Without apiKey.read, API actors are masked, including the current API actor. An API actor that is not the current actor also needs user.read to remain visible.
  • The legacy contact.read permission also allows contact actors to be visible.

Request

Path parameters

  • organizationIdidrequired
  • mandateIdidrequired
  • bookingIdidrequired

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/bookings/YOUR_BOOKING_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

    When the caller cannot view an actor, [].actor may be replaced with a guest or system actor with a permission-placeholder name.

  • reviewedByobjectnullable
  • 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
404Booking was not foundIf the booking is not found in the requested organization and mandate, the endpoint returns HTTP 404 NOT_FOUND with key routes.booking.bookings.noBooking.

Errors nearly every request can meet are listed under Errors.