Create a booking
POST
/bookings
Bookings
Last modified:2026-06-05 10:12:55
Maintainer:Not configured
POST /training-events/{id}/hold first to obtain a hold_hash.Payment Options
pay_option | Behaviour |
|---|---|
credits | Deducts 1 booking credit for the course. Confirmed immediately. |
balance | Deducts the course cost from your GBP money balance. Confirmed immediately. |
inv | Raised as an invoice. Confirmed immediately. Requires invoice_payments enabled on your account. |
candidate_pays | Candidate receives a Stripe checkout link via email. Booking is pending until payment completes. The payment_url is included in the response. |
PMVA Bookings
pending and require admin review before confirmation.Request
Body Params application/jsonRequired
Responses
Request Request Example
Shell
JavaScript
Java
Swift
cURL
curl --location '/bookings' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
"hold_hash": "Xy7kRtQmNpLsWvBzJcFdEaHgUiOeYtAn",
"first_name": "Jane",
"last_name": "Smith",
"email": "jane.smith@nhsstaff.co.uk",
"phone": "+441234567890",
"job_role": "Registered Nurse",
"pay_option": "credits",
"agency_contact_name": "John Doe",
"agency_contact_email": "john.doe@acme.co.uk",
"agency_email": "invoices@acme.co.uk"
}'Response Response Example
201 - Confirmed booking (credits)
{
"id": 95759,
"candidate": {
"name": "Jane Smith",
"email": "jane.smith@nhsstaff.co.uk",
"phone": "+441234567890",
"job_role": "Registered Nurse"
},
"course": {
"id": 1,
"name": "CSTF All-In-One Mandatory Practical Training"
},
"location": {
"id": 3,
"name": "Glasgow",
"address": "Abbey Mill Business Centre, Paisley"
},
"trainer": {
"id": 5,
"name": "David Rankin"
},
"start_date": "2026-07-15T10:00:00+01:00",
"end_date": "2026-07-15T17:00:00+01:00",
"booking_status": "booked",
"pay_status": "completed",
"pay_option": "credits",
"booked_by": "Agency",
"attendance": null,
"certificate_available": false,
"created_at": "2026-06-05T10:00:00+00:00"
}Modified at 2026-06-05 10:12:55