Get DMS service booking capabilities

GET

/api/v1/dealerships/{dealership_id}/service_booking/capabilities

const url = 'https://dashboard.dealerstudio.com.au/api/v1/dealerships/1/service_booking/capabilities';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://dashboard.dealerstudio.com.au/api/v1/dealerships/1/service_booking/capabilities \
  --header 'Authorization: Bearer <token>'

Returns capability flags and the resolved DMS provider for a dealership. Requires API key authentication with the dms_service_booking:dealership permission. Clients should adapt UI copy from these flags (e.g. show “Booking request submitted” when direct_confirmation is false) rather than branching on provider name.

Authorizations

Bearer

Parameters

Path Parameters

dealership_id

required

integer

Dealership ID

Responses

200

Capabilities returned

application/json

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

{
  "provider": "titan",
  "service_options": true,
  "live_availability": true,
  "direct_confirmation": true,
  "rescheduling": false,
  "cancellation": false,
  "separate_collection_times": false
}

403

API key lacks permission

application/json

object

error

string

Example

{
  "error": "forbidden"
}

422

Dealership not configured for DMS service booking

application/json

object

error

required

Machine-readable code (e.g. not_configured, not_found, provider_error, forbidden, validation_error)

string

message

string

Example

{
  "error": "not_configured",
  "message": "Dealership is not configured for DMS service booking"
}