Booking Flow

Session Bookings

A SessionBooking records a customer's attendance against a specific session occurrence — captures check-in, no-show, intake form status and arrival stage so reception staff can manage walk-in flow.

The SessionBooking object

Attributes

idstringrequired
The ID of the session.
checked_in_atdate-timerequirednullable
The time this booking was checked in.
checked_out_atdate-timerequirednullable
The time this booking was checked out.
customer_idstringrequired
The ID of the customer this booking is for.
emailstringrequired
The email address of the customer.
first_namestringrequired
The first name of the customer.
guestsobject[]required
intake_forms_completedbooleanrequired
Whether the required intake form has been completed.
intake_form_requiredbooleanrequired
Whether the session booking requires an intake form to be completed.
is_no_showbooleanrequired
Whether this booking was marked as a no-show.
last_namestringrequired
The last name of the customer.
order_idstringrequired
The ID of the order associated with this session.
order_item_idstringrequired
The ID of the order item associated with this session.
order_refstringrequired
The order reference associated with this session.
organisation_idstringrequired
The ID of the organisation the session booking belongs to.
phonestringrequired
The customer's phone number.
session_idstringrequired
The ID of the session this booking is for.
session_type_idstringrequired
The ID of the session type.
session_type_namestringrequired
The name of the session type.
site_idstringrequired
The ID of the site the session booking belongs to.
stagestringrequired
The current stage of the order the session belongs to.
Possible values:not_arrivedarrivedin_treatmentchecked_out
statusstringrequired
The status of the booking.
Possible values:newin_progressconfirmedwaitlisted
created_atdate-timerequired
A datetime string of when the resource was created.
updated_atdate-timerequired
A datetime string of when the resource was last updated.

{
  "id": "5dcb47800000000000000000",
  "checked_in_at": "2022-03-02T09:00:00+00:00",
  "checked_out_at": "2022-03-02T10:00:00+00:00",
  "customer_id": "5dcb47800000000000000020",
  "email": "janedoe@example.com",
  "first_name": "Jane",
  "guests": [
    "string"
  ],
  "intake_forms_completed": false,
  "intake_form_required": true,
  "is_no_show": true,
  "last_name": "Doe",
  "order_id": "5dcb47800000000000000009",
  "order_item_id": "5dcb47800000000000000019",
  "order_ref": "TRY00",
  "organisation_id": "00000000-0000-0000-0000-000000000000",
  "phone": "+447727123456",
  "session_id": "5dcb47800000000000001111",
  "session_type_id": "5dcb47800000000000001234",
  "session_type_name": "Spa access",
  "site_id": "00000000-0000-0000-0000-111111111111",
  "stage": "not_arrived",
  "status": "none",
  "created_at": "2026-01-15T09:30:00+00:00",
  "updated_at": "2026-01-15T09:30:00+00:00"
}

post/shop/session-bookings/{bookingId}/check-in

Check a guest in to a session booking

actionCheckInSessionBooking

Marks a SessionBooking as checked in. Used by front-of-house staff and self-service kiosks at the start of a session to record arrival. Setting is_checked_in to false reverses an earlier check-in.

The request body is optional — calling the endpoint with no body is equivalent to passing { "is_checked_in": true }.

Path parameters

bookingIdobject-idrequired
The ID of the SessionBooking.

Request body

is_checked_inbooleanoptional
Set to false to clear an existing check-in. Defaults to true when omitted, marking the booking as checked in.

Responses

200
A single SessionBooking.
400
The request failed.
401
The user is unauthenticated
403
The authenticated user does not have permission.
404
The resource couldn't be found
422
The request didn't pass validation

curl -X POST "https://api.playground.try.be/shop/session-bookings/5dcb47800000000000000000/check-in" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
  "is_checked_in": true
}'

const response = await fetch('https://api.playground.try.be/shop/session-bookings/5dcb47800000000000000000/check-in', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
    Accept: 'application/json',
  },
  body: JSON.stringify({
    "is_checked_in": true
  }),
})

if (!response.ok) {
  throw new Error(`Trybe API ${response.status}: ${await response.text()}`)
}

const data = await response.json()

import httpx

response = httpx.post(
    "https://api.playground.try.be/shop/session-bookings/5dcb47800000000000000000/check-in",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Accept": "application/json",
        "Content-Type": "application/json",
    },
    json={
        "is_checked_in": True
    },
)
response.raise_for_status()
data = response.json()

<?php

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://api.playground.try.be/shop/session-bookings/5dcb47800000000000000000/check-in', [
    'headers' => [
        'Authorization' => 'Bearer YOUR_API_KEY',
        'Accept' => 'application/json',
        'Content-Type' => 'application/json',
    ],
    'json' => [
            'is_checked_in' => true
        ],
]);

$data = json_decode($response->getBody(), true);

package main

import (
	"bytes"
	"encoding/json"
	"net/http"
)

func main() {
	payload, _ := json.Marshal(map[string]interface{}{
		"is_checked_in": true,
	})
	req, _ := http.NewRequest("POST", "https://api.playground.try.be/shop/session-bookings/5dcb47800000000000000000/check-in", bytes.NewBuffer(payload))
	req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
	req.Header.Set("Accept", "application/json")
	req.Header.Set("Content-Type", "application/json")
	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()
	var data map[string]interface{}
	json.NewDecoder(resp.Body).Decode(&data)
}

A single `SessionBooking`.

{
  "data": {
    "id": "5dcb47800000000000000000",
    "checked_in_at": "2022-03-02T09:00:00+00:00",
    "checked_out_at": "2022-03-02T10:00:00+00:00",
    "customer_id": "5dcb47800000000000000020",
    "email": "janedoe@example.com",
    "first_name": "Jane",
    "guests": [
      {
        "id": "5dcb47800000000000000000",
        "checked_in_at": "2025-10-01T12:00:00+00:00",
        "checked_out_at": "2025-10-01T16:30:00+00:00",
        "customer_id": "5f8a1b2c-9d3e-4a5b-8c6d-7e8f9a0b1c2d",
        "email": "jane.doe@example.com",
        "first_name": "Jane",
        "intake_form_submission_id": "5dcb47800000000000000010",
        "intake_form_complete": false,
        "is_lead_booker": true,
        "last_name": "Doe",
        "name": "Jane Doe"
      }
    ],
    "intake_forms_completed": false,
    "intake_form_required": true,
    "is_no_show": true,
    "last_name": "Doe",
    "order_id": "5dcb47800000000000000009",
    "order_item_id": "5dcb47800000000000000019",
    "order_ref": "TRY00",
    "organisation_id": "00000000-0000-0000-0000-000000000000",
    "phone": "+447727123456",
    "session_id": "5dcb47800000000000001111",
    "session_type_id": "5dcb47800000000000001234",
    "session_type_name": "Spa access",
    "site_id": "00000000-0000-0000-0000-111111111111",
    "stage": "not_arrived",
    "status": "none",
    "created_at": "2026-01-15T09:30:00+00:00",
    "updated_at": "2026-01-15T09:30:00+00:00"
  }
}

{
  "message": "string"
}

{
  "message": "Unauthenticated"
}

{
  "message": "This action is unauthorized."
}

{
  "message": "The requested resource could not be found"
}

{
  "errors": {},
  "message": "The request didn't pass validation"
}

post/shop/session-bookings/{bookingId}/check-out

Check a guest out of a session booking

actionCheckOutSessionBooking

Marks a SessionBooking as checked out. Used by front-of-house staff and self-service kiosks at the end of a session to record departure. Setting is_checked_out to false reverses an earlier check-out.

The request body is optional — calling the endpoint with no body is equivalent to passing { "is_checked_out": true }.

Path parameters

bookingIdobject-idrequired
The ID of the SessionBooking.

Request body

is_checked_outbooleanoptional
Set to false to clear an existing check-out. Defaults to true when omitted, marking the booking as checked out.

Responses

200
A single SessionBooking.
400
The request failed.
401
The user is unauthenticated
403
The authenticated user does not have permission.
404
The resource couldn't be found
422
The request didn't pass validation

curl -X POST "https://api.playground.try.be/shop/session-bookings/5dcb47800000000000000000/check-out" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
  "is_checked_out": true
}'

const response = await fetch('https://api.playground.try.be/shop/session-bookings/5dcb47800000000000000000/check-out', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
    Accept: 'application/json',
  },
  body: JSON.stringify({
    "is_checked_out": true
  }),
})

if (!response.ok) {
  throw new Error(`Trybe API ${response.status}: ${await response.text()}`)
}

const data = await response.json()

import httpx

response = httpx.post(
    "https://api.playground.try.be/shop/session-bookings/5dcb47800000000000000000/check-out",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Accept": "application/json",
        "Content-Type": "application/json",
    },
    json={
        "is_checked_out": True
    },
)
response.raise_for_status()
data = response.json()

<?php

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://api.playground.try.be/shop/session-bookings/5dcb47800000000000000000/check-out', [
    'headers' => [
        'Authorization' => 'Bearer YOUR_API_KEY',
        'Accept' => 'application/json',
        'Content-Type' => 'application/json',
    ],
    'json' => [
            'is_checked_out' => true
        ],
]);

$data = json_decode($response->getBody(), true);

package main

import (
	"bytes"
	"encoding/json"
	"net/http"
)

func main() {
	payload, _ := json.Marshal(map[string]interface{}{
		"is_checked_out": true,
	})
	req, _ := http.NewRequest("POST", "https://api.playground.try.be/shop/session-bookings/5dcb47800000000000000000/check-out", bytes.NewBuffer(payload))
	req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
	req.Header.Set("Accept", "application/json")
	req.Header.Set("Content-Type", "application/json")
	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()
	var data map[string]interface{}
	json.NewDecoder(resp.Body).Decode(&data)
}

A single `SessionBooking`.

{
  "data": {
    "id": "5dcb47800000000000000000",
    "checked_in_at": "2022-03-02T09:00:00+00:00",
    "checked_out_at": "2022-03-02T10:00:00+00:00",
    "customer_id": "5dcb47800000000000000020",
    "email": "janedoe@example.com",
    "first_name": "Jane",
    "guests": [
      {
        "id": "5dcb47800000000000000000",
        "checked_in_at": "2025-10-01T12:00:00+00:00",
        "checked_out_at": "2025-10-01T16:30:00+00:00",
        "customer_id": "5f8a1b2c-9d3e-4a5b-8c6d-7e8f9a0b1c2d",
        "email": "jane.doe@example.com",
        "first_name": "Jane",
        "intake_form_submission_id": "5dcb47800000000000000010",
        "intake_form_complete": false,
        "is_lead_booker": true,
        "last_name": "Doe",
        "name": "Jane Doe"
      }
    ],
    "intake_forms_completed": false,
    "intake_form_required": true,
    "is_no_show": true,
    "last_name": "Doe",
    "order_id": "5dcb47800000000000000009",
    "order_item_id": "5dcb47800000000000000019",
    "order_ref": "TRY00",
    "organisation_id": "00000000-0000-0000-0000-000000000000",
    "phone": "+447727123456",
    "session_id": "5dcb47800000000000001111",
    "session_type_id": "5dcb47800000000000001234",
    "session_type_name": "Spa access",
    "site_id": "00000000-0000-0000-0000-111111111111",
    "stage": "not_arrived",
    "status": "none",
    "created_at": "2026-01-15T09:30:00+00:00",
    "updated_at": "2026-01-15T09:30:00+00:00"
  }
}

{
  "message": "string"
}

{
  "message": "Unauthenticated"
}

{
  "message": "This action is unauthorized."
}

{
  "message": "The requested resource could not be found"
}

{
  "errors": {},
  "message": "The request didn't pass validation"
}

post/shop/session-bookings/{bookingId}/no-show

Mark a session booking as a no-show

actionMarkSessionBookingNoShow

Flags a SessionBooking as a no-show. Used by front-of-house staff after the session start time has elapsed without the guest arriving. Setting is_no_show to false reverses an earlier no-show flag.

The request body is optional — calling the endpoint with no body is equivalent to passing { "is_no_show": true }.

Path parameters

bookingIdobject-idrequired
The ID of the SessionBooking.

Request body

is_no_showbooleanoptional
Set to false to clear an existing no-show flag. Defaults to true when omitted.

Responses

200
A single SessionBooking.
400
The request failed.
401
The user is unauthenticated
403
The authenticated user does not have permission.
404
The resource couldn't be found
422
The request didn't pass validation

curl -X POST "https://api.playground.try.be/shop/session-bookings/5dcb47800000000000000000/no-show" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Accept: application/json" \
  -H "Content-Type: application/json" \
  -d '{
  "is_no_show": true
}'

const response = await fetch('https://api.playground.try.be/shop/session-bookings/5dcb47800000000000000000/no-show', {
  method: 'POST',
  headers: {
    Authorization: 'Bearer YOUR_API_KEY',
    'Content-Type': 'application/json',
    Accept: 'application/json',
  },
  body: JSON.stringify({
    "is_no_show": true
  }),
})

if (!response.ok) {
  throw new Error(`Trybe API ${response.status}: ${await response.text()}`)
}

const data = await response.json()

import httpx

response = httpx.post(
    "https://api.playground.try.be/shop/session-bookings/5dcb47800000000000000000/no-show",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Accept": "application/json",
        "Content-Type": "application/json",
    },
    json={
        "is_no_show": True
    },
)
response.raise_for_status()
data = response.json()

<?php

$client = new \GuzzleHttp\Client();

$response = $client->request('POST', 'https://api.playground.try.be/shop/session-bookings/5dcb47800000000000000000/no-show', [
    'headers' => [
        'Authorization' => 'Bearer YOUR_API_KEY',
        'Accept' => 'application/json',
        'Content-Type' => 'application/json',
    ],
    'json' => [
            'is_no_show' => true
        ],
]);

$data = json_decode($response->getBody(), true);

package main

import (
	"bytes"
	"encoding/json"
	"net/http"
)

func main() {
	payload, _ := json.Marshal(map[string]interface{}{
		"is_no_show": true,
	})
	req, _ := http.NewRequest("POST", "https://api.playground.try.be/shop/session-bookings/5dcb47800000000000000000/no-show", bytes.NewBuffer(payload))
	req.Header.Set("Authorization", "Bearer YOUR_API_KEY")
	req.Header.Set("Accept", "application/json")
	req.Header.Set("Content-Type", "application/json")
	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()
	var data map[string]interface{}
	json.NewDecoder(resp.Body).Decode(&data)
}

A single `SessionBooking`.

{
  "data": {
    "id": "5dcb47800000000000000000",
    "checked_in_at": "2022-03-02T09:00:00+00:00",
    "checked_out_at": "2022-03-02T10:00:00+00:00",
    "customer_id": "5dcb47800000000000000020",
    "email": "janedoe@example.com",
    "first_name": "Jane",
    "guests": [
      {
        "id": "5dcb47800000000000000000",
        "checked_in_at": "2025-10-01T12:00:00+00:00",
        "checked_out_at": "2025-10-01T16:30:00+00:00",
        "customer_id": "5f8a1b2c-9d3e-4a5b-8c6d-7e8f9a0b1c2d",
        "email": "jane.doe@example.com",
        "first_name": "Jane",
        "intake_form_submission_id": "5dcb47800000000000000010",
        "intake_form_complete": false,
        "is_lead_booker": true,
        "last_name": "Doe",
        "name": "Jane Doe"
      }
    ],
    "intake_forms_completed": false,
    "intake_form_required": true,
    "is_no_show": true,
    "last_name": "Doe",
    "order_id": "5dcb47800000000000000009",
    "order_item_id": "5dcb47800000000000000019",
    "order_ref": "TRY00",
    "organisation_id": "00000000-0000-0000-0000-000000000000",
    "phone": "+447727123456",
    "session_id": "5dcb47800000000000001111",
    "session_type_id": "5dcb47800000000000001234",
    "session_type_name": "Spa access",
    "site_id": "00000000-0000-0000-0000-111111111111",
    "stage": "not_arrived",
    "status": "none",
    "created_at": "2026-01-15T09:30:00+00:00",
    "updated_at": "2026-01-15T09:30:00+00:00"
  }
}

{
  "message": "string"
}

{
  "message": "Unauthenticated"
}

{
  "message": "This action is unauthorized."
}

{
  "message": "The requested resource could not be found"
}

{
  "errors": {},
  "message": "The request didn't pass validation"
}