Skip to content
Dealer Studio API Docs

Calculate Government Charges

POST
/api/v1/government_charges/calculate

Calculates government charges (registration, CTP, stamp duty, etc.) for a vehicle based on its attributes and jurisdiction. This endpoint is intended for external API consumers and requires API key authentication with the calculate:government_charge permission. Pricing (base_price and dealer_delivery_fee) is automatically calculated from the model variant and selected colours. Vehicle attributes are automatically extracted from the model variant.

Authorizations

Section titled “Authorizations ”

Request Body required

Section titled “Request Body required ”
object
model_variant_id
required

Required. ID of the model variant. Vehicle attributes (fuel_kind, seats, year, tare_weight, engine_size_litres, body_type, vehicle_category, etc.) are automatically extracted from the model variant. Base price is calculated from model_variant.dap_min_price + exterior_colour.price + interior_colour.price. Dealer delivery fee is retrieved from model_variant.recommended_dealer_delivery_fee.

integer
Example
123
vehicle_use
required

Required. Vehicle use type

string
Allowed values: private commercial
Example
private
interior_colour_id
required

Required. ID of the interior colour. The colour price is added to the base price calculation.

integer
Example
456
exterior_colour_id
required

Required. ID of the exterior colour. The colour price is added to the base price calculation.

integer
Example
789
state
required

Required. Australian state or territory for which to calculate charges

string
Allowed values: ACT NSW NT QLD SA TAS VIC WA
Example
NSW
vehicle_condition

Optional. Vehicle condition. If not specified, defaults to “new”

string
Allowed values: new demo used
Example
new
postcode

Optional. Postcode for jurisdiction-specific calculations (e.g., VIC CTP zones)

string
Example
3000

Responses

Section titled “ Responses ”

200

Section titled “200 ”

Government charges calculated with model variant and colours

object
results
required
Array<object>
object
charge_definition_id
required
integer
Example
1
charge_definition_label
required
string
Example
NSW Vehicle Registration
charge_definition_code
required
string
Example
registration
charge_definition_jurisdiction
required
string
Example
NSW
rule_id
required
integer
Example
1
rule_notes
string
nullable
Example
Standard registration fee
amount_cents
required
integer
Example
10000
amount
required
number format: float
Example
100
calculation_method
required
string
Allowed values: static tiered formula external_api
Example
static
base_price
required

Base price (EGC) in dollars, calculated from model_variant.dap_min_price + exterior_colour.price + interior_colour.price

number format: float
Example
72995
dealer_delivery_fee
required

Dealer delivery fee in dollars, retrieved from model_variant.recommended_dealer_delivery_fee

number format: float
Example
1995

401

Section titled “401 ”

Unauthorized - API key lacks required permission

object
error
required
string
Example
Invalid or missing API key

422

Section titled “422 ”

Missing required parameter - state

object
error
required
string
Example
state is required