Skip to content
Dealer Studio API Docs

List available booking slots

GET
/api/v1/dealerships/{dealership_id}/service_booking/availability
curl --request GET \
  --url 'https://dashboard.dealerstudio.com.au/api/v1/dealerships/1/service_booking/availability?date_from=2026-10-01&date_to=2026-10-07' \
  --header 'Authorization: Bearer <token>'

Returns live availability slots from the DMS for the given date range. When capabilities.separate_collection_times is true, call once for drop-off slots and again with pickup_after set to the chosen drop-off. Requires dms_service_booking:dealership.

Authorizations

Section titled “Authorizations”

Parameters

Section titled “Parameters”

Path Parameters

Section titled “Path Parameters”
dealership_id
required
integer

Dealership ID

Query Parameters

Section titled “Query Parameters”
date_from
required
string

Start date (YYYY-MM-DD)

Example 

2026-10-01
date_to
required
string

End date (YYYY-MM-DD)

Example 

2026-10-07
workshop_id
integer

Optional single workshop ID

workshop_ids
Array<integer>

Optional list of workshop IDs

make_id
integer

Optional DMS make ID filter

duration_hours
number

Operation hours used to calculate slots. TUNE uses this, or the department default.

pickup_after
string

Drop-off timestamp (YYYY-MM-DDTHH:MM:SS). When set, returns collection times. Used when separate_collection_times is true.

registration_number
string

Registration, used with service_code to look up TUNE operation time

service_code
string

Selected service code, used to look up TUNE operation time

Responses

Section titled “Responses”

200

Section titled “200”

Available slots returned

Media typeapplication/json
object
slots
required
Array<object>
object
slot_id
integer
kind
string
nullable
workshop_id
integer
booking_date
string
starts_at
required
string
ends_at
required
string
duration_minutes
integer
advisor_id

Titan service advisor for the slot. Echo on POST /bookings as advisor_id.

integer
transport_option_ids
Array<integer>
nullable
capabilities
required
object
provider
required
string
service_options
required
boolean
live_availability
required
boolean
direct_confirmation
required
boolean
rescheduling
required
boolean
cancellation
required
boolean
separate_collection_times
required
boolean

Example 

{
  "slots": [
    {
      "slot_id": 101,
      "kind": "dropoff",
      "workshop_id": 7,
      "booking_date": "2026-10-01",
      "starts_at": "2026-10-01T09:00:00",
      "ends_at": "2026-10-01T10:00:00",
      "duration_minutes": 60,
      "advisor_id": 5
    }
  ],
  "capabilities": {
    "provider": "titan",
    "service_options": true,
    "live_availability": true,
    "direct_confirmation": true,
    "rescheduling": false,
    "cancellation": false,
    "separate_collection_times": false
  }
}