Get specific booking by ID (Admin)

Retrieve a specific booking by its ID. Requires admin authentication.

GET

https://api.channelautomation.com/api/calendar/bookings/{id}

Authorization

BearerAuth
optional
HTTP Bearer (JWT)

ApiKeyAuth
optional
API key in header

Path parameters

id
string
required
Booking ID

Returns

200

Booking retrieved successfully

JSON

success
optional
boolean
booking
optional
object
- id
  optional
  string
  Unique appointment identifier
- contact_id
  optional
  string
  Associated contact ID
- workspace_id
  optional
  string
  Workspace ID
- created_by
  optional
  string
  ID of user who created the appointment
- title
  optional
  string
  Appointment title
- description
  optional
  string
  Appointment description
- appointment_date
  optional
  string
  Date and time of the appointment
  
  format: date-time
- duration_minutes
  optional
  integer
  Duration of the appointment in minutes
- location
  optional
  string
  Location of the appointment
- created_at
  optional
  string
  When the appointment was created
  
  format: date-time
- updated_at
  optional
  string
  When the appointment was last updated
  
  format: date-time
}

401

Authentication required

JSON

error
optional
string
success
optional
boolean

403

Admin privileges required

JSON

error
optional
string
success
optional
boolean

404

Booking not found

JSON

success
optional
boolean
error
optional
string

500

Internal server error

JSON

error
optional
string
details
optional
string
success
optional
boolean

Get specific booking by ID (Admin)

curl --request GET \
  --url https://api.channelautomation.com/api/calendar/bookings/372e579b-7f9a-47ed-b161-24e69670035b \
  --header 'Authorization: Bearer <token>'

const url = 'https://api.channelautomation.com/api/calendar/bookings/372e579b-7f9a-47ed-b161-24e69670035b';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch(url, options)
  .then(res => res.json())
  .then(json => console.log(json))
  .catch(err => console.error(err));

import requests

url = "https://api.channelautomation.com/api/calendar/bookings/372e579b-7f9a-47ed-b161-24e69670035b"

headers = {"Authorization": "Bearer <token>"}

response = requests.get(url, headers=headers)

print(response.text)

Response example

{
  "success": true,
  "booking": {
    "id": "appointment-uuid",
    "contact_id": "contact-uuid",
    "workspace_id": "workspace-uuid",
    "created_by": "464cf603-5a10-4470-a100-331fc0766680",
    "title": "Kitchen Renovation - John Smith",
    "description": "Kitchen Renovation booking for John Smith ([email protected])",
    "appointment_date": "2025-07-15T09:00:00Z",
    "duration_minutes": 60,
    "location": "Customer's home",
    "created_at": "2025-07-08T10:00:00Z",
    "updated_at": "2025-07-08T10:00:00Z"
  }
}

{
  "error": "Authentication required",
  "success": false
}

{
  "error": "Admin privileges required",
  "success": false
}

{
  "success": false,
  "error": "Booking not found"
}

{
  "error": "Internal server error",
  "details": "string",
  "success": false
}