API ReferenceBookings
Get a booking
GET
/v1/bookings/{id}Fetch a single court booking by id. A CANCELLED booking is served here — a stored link must not break when a booking is cancelled — and reports it through status and canceled_at, with its courts and times preserved as they stood at cancellation. The list is the surface that hides cancelled bookings by default; retrieval by id is not. Returns 404 if the id is not a booking of the club tied to your API key — including a program's id, which belongs to GET /v1/events/{id}.
Authorization
bearerAuth AuthorizationBearer <token>
Your club API key. Send it as Authorization: Bearer oc_live_….
In: header
Path Parameters
id*string
The booking id.
Response Body
application/json
application/json
application/json
application/json
curl -X GET "https://api.getopencourt.com/v1/bookings/7c1a9e30-5b2d-4f68-9a41-8e0d3c6b2f95"{
"id": "7c1a9e30-5b2d-4f68-9a41-8e0d3c6b2f95",
"object": "booking",
"status": "confirmed",
"customer_id": "3f29c4a1-7b6d-4e52-9c81-2a4b6d8e0f13",
"title": null,
"business_date": "2026-06-15",
"start": "2026-06-15T18:00:00-04:00",
"end": "2026-06-15T19:30:00-04:00",
"spaces": [
{
"id": "b2d4f6a8-1c3e-4a5b-9d7c-0e2f4a6b8c1d",
"name": "Court 1",
"start": "2026-06-15T18:00:00-04:00",
"end": "2026-06-15T19:30:00-04:00"
}
],
"open": false,
"privacy": "private",
"party_size": 4,
"participant_count": 3,
"max_participants": 4,
"spots_available": 1,
"created_at": "2026-06-10T13:04:22.000Z",
"updated_at": "2026-06-10T13:04:22.000Z",
"canceled_at": null
}{
"error": {
"type": "string",
"code": "string",
"message": "string",
"param": "string",
"request_id": "string"
}
}{
"error": {
"type": "string",
"code": "string",
"message": "string",
"param": "string",
"request_id": "string"
}
}{
"error": {
"type": "string",
"code": "string",
"message": "string",
"param": "string",
"request_id": "string"
}
}