---
title: "Choose a time to book at a clinic"
method: POST
path: "/api/public/dental-network/tools/choose_public_booking_time"
---

# Choose a time to book at a clinic

`POST /api/public/dental-network/tools/choose_public_booking_time`

## Request

- Base URL: `https://book.xonark.com`
- URL: `https://book.xonark.com/api/public/dental-network/tools/choose_public_booking_time`
- Auth: none required

For a public_provider_booking action: keeps one time from list_public_booking_slots (or a soonest search row's earliest) and returns continue_url, Xona's page where the patient enters their own details and presses Book. Xona then books that time in the clinic's own scheduler. It takes the action and the time (service_id, slot_id, starts_at) only, reads that time again and keeps it only if it is still open; the page collects the patient's details.

## Request body

- object
  - `action_id` string, required
  - `service_id` string, required: The chosen time's service_id.
  - `slot_id` string, required: The chosen time's id from list_public_booking_slots (slot_id on a soonest row's earliest).
  - `starts_at` string, date-time, required: The chosen time's starts_at, exactly as returned.

## Response `200`

Choose a time to book at a clinic

- object
  - `booking` object, required
    - `action_id` string, required
    - `continue_url` string
    - `practice_slug` string, required
    - `provider` string
    - `service` string, required
    - `stage` string, required
    - `start_local` string, required
    - `starts_at` string, date-time, required
    - `time_zone` string
  - `continue_url` string, required
  - `next_step` string, required

## Other responses

- `400`: Invalid request or action state
- `403`: Public write is disabled, or not a member of the claiming account
- `404`: Dental resource not found
- `410`: Dental action expired
- `413`: Request body too large
- `429`: Rate limit exceeded
- `502`: Clinic booking provider is unavailable
- `503`: Gateway temporarily unavailable
- `504`: Clinic booking provider timed out

---

[API](https://skmtc.dev/xonark/apis/xona-dental-gateway-public-api.md) · [All operations](https://skmtc.dev/xonark/apis/xona-dental-gateway-public-api/llms.txt) · [OpenAPI document](https://skmtc.dev/xonark/apis/xona-dental-gateway-public-api/revisions/886252359184?raw)