Vehicle Management

These endpoints provide access to vehicle product information such as specifications, option details, pricing, warranty coverage, and eligibility for subscriptions and upgrades. They also support enterprise operations like managing payer accounts and querying vehicle roles.

Endpoints

eligible_subscriptions

GET /api/1/dx/vehicles/subscriptions/eligibility?vin={vin}

Returns eligible vehicle subscriptions.

eligible_upgrades

GET /api/1/dx/vehicles/upgrades/eligibility?vin={vin}

Returns eligibile vehicle upgrades.

enterprise_payer

POST /api/1/dx/enterprise/v1/{vin}/payer

Set payer roles for a vehicle.

enterprise_roles

GET /api/1/dx/enterprise/v1/{vin}/roles

Get enterprise roles for a vehicle.

options

GET /api/1/dx/vehicles/options?vin={vin}

Returns vehicle option details.

pricing

POST /api/1/dx/vehicles/pricing

Returns pricing details for a vehicle model in a specific market.

specs

GET /api/1/vehicles/{vin}/specs

Returns vehicle specifications as recorded at the time of sale, plus current battery health estimates when available. This endpoint has special pricing: $0.10 per successful result.

This endpoint can only be accessed with Partner Tokens and can be used for any vehicle without owner authorization.

Battery fields are current estimates from vehicle telemetry. They may be null if no estimate is available.

batteryCapacityKwh: Current estimated usable (net) pack energy in kWh.
batterySoH: Remaining usable energy as a percentage of beginning-of-life usable energy. Early in pack life this value may be rounded to 100%.
batterySoHTimestamp: UTC timestamp of the latest battery capacity estimate.

warranty_details

GET /api/1/dx/warranty/details

Returns the warranty information for a vehicle.