Skip to content
Dealer Studio API Docs

List service options for a VIN

GET
/api/v1/dealerships/{dealership_id}/service_booking/services
curl --request GET \
  --url 'https://dashboard.dealerstudio.com.au/api/v1/dealerships/1/service_booking/services?vin=JTDBR32E720012345&odometer=42000' \
  --header 'Authorization: Bearer <token>'

Returns normalised service options for a vehicle. Titan looks up via POST /ServiceBooking/operationCodes (VIN and optional registration_number) and only returns items with service_maintenance_kms greater than 10 and less than 500,000. TUNE looks up by registration_number and parses kilometre intervals from schedule operation names into service_maintenance_kms when present. When odometer is supplied, interval-based services are narrowed to the previous and next maintenance intervals around that reading, and the next due service is flagged with recommended=true. Upsells and other services without an interval are always kept. Provide at least one of vin or registration_number. 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”
vin
string

Vehicle VIN. Provide vin, registration_number, or both.

Example 

JTDBR32E720012345
registration_number
string

Registration number. Required for TUNE service options.

odometer
integer

Current odometer in kilometres. When present, filters interval-based services to those nearest this reading.

Example 

42000
workshop_id
integer

Optional workshop ID (defaults to first workshop from WorkshopList)

make_id
string

Optional Titan make ID used for availability lookups

Responses

Section titled “Responses”

200

Section titled “200”

Service options returned

Media typeapplication/json
object
workshop_id
required
integer
services
required
Array<object>
object
code
required
string
name
string
description
string
nullable
duration_hours
number
nullable
price
number
nullable
currency_code
string
nullable
service_maintenance_kms
integer
nullable
recommended
boolean
nullable
operation_type
string
nullable
row_id
string
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 

{
  "workshop_id": 7,
  "services": [
    {
      "code": "LOG15",
      "name": "15,000km Service",
      "duration_hours": 2,
      "price": 349,
      "currency_code": "AUD",
      "service_maintenance_kms": 15000,
      "recommended": true,
      "operation_type": "schedule"
    }
  ],
  "capabilities": {
    "provider": "titan",
    "service_options": true,
    "live_availability": true,
    "direct_confirmation": true,
    "rescheduling": false,
    "cancellation": false,
    "separate_collection_times": false
  }
}