This endpoint returns the change history of a booking, newest first.
Important Notes
- Requires
bookings:readscope. - Each entry carries
user {id}: the AgendaPro user who made the change, ornullwhen the change had no user (a system process, an online booking). The user's email is not exposed.employee_codeidentifies who acted when the company uses employee codes. - The history is not filtered by status: a booking has few entries, so read all of its pages and derive the status changes on your side (recipe below).
Recipe: who marked the booking as attended or no-show
Read the whole history (every page) and walk it from oldest to newest (the list comes newest first). A status transition is an entry whose status.id differs from the entry right before it in time, or the oldest entry. Who marked the booking as attended (status.id 3) or no-show (status.id 6) is the user.id of the most recent transition to that status (null when the change had no user), and its created_at is when. A later entry that keeps the status (an edit of an attended booking) is not a transition: in 1 → 3 (A) → 3 (B) A marked it, while in 1 → 3 (A) → 1 → 3 (B) B did. No transition to that status means nobody marked it. The booking's current status.id tells whether that mark still holds.
Errors Dictionary
| Status | Error | Detail | Description |
|---|---|---|---|
| 400 | (upstream) | page or per_page is not a positive integer; legacy single-key code from platform-bookings. | |
| 401 | unauthorized | invalid_api_key | Missing or invalid Bearer token. |
| 401 | unauthorized | api_config_inactive | API access is inactive for this company. |
| 403 | forbidden | scope_denied | API key lacks bookings:read scope. |
| 404 | not_found | booking | Booking not found, or it belongs to another company. |
| 429 | rate_limited | burst_limit_exceeded | Per-minute request limit exceeded. |
| 429 | rate_limited | daily_quota_exceeded | Daily request quota exceeded. |
| 502 | upstream_unavailable | connection_failed | The upstream service is unavailable. |
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
