Connectivity

Connect vehicles via SmartCar OAuth, retrieve linked VINs by driver email, and sync real-time compliance data (odometer, OBD codes, oil life) in a single call.

Configuration

Vehicle Connectivity (SmartCar)

Authorize access to vehicle data via SmartCar using the JS SDK. This flow exchanges an authorization code for vehicle tokens.

POST /api/v1/smartcar/exchange

Request Parameters

ParameterTypeRequiredDescription
driver_emailstringYesEmail of the driver to initiate SmartCar OAuth for.

Example Request

curl -X POST https://dev.api.aiadmin.quickmechs.com/api/v1/smartcar/exchange \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"driver_email":"driver@example.com"}'
Try it

Clicking the button below will fetch the authorization URL for this driver and redirect you to the SmartCar vehicle selector.

Request
GET /api/v1/smartcar/connect
Response
// Click connect to start the OAuth flow

SmartCar VIN Lookup

Retrieve all active vehicle VINs associated with a specific driver email through SmartCar connections.

GET /api/v1/smartcar/vin-lookup

Request Parameters

ParameterTypeRequiredDescription
emailstringYesQuery param. Driver email to look up connected VINs for.

Example Request

curl -X GET "https://dev.api.aiadmin.quickmechs.com/api/v1/smartcar/vin-lookup?email=driver%40example.com" \
  -H "Authorization: Bearer YOUR_API_KEY"
Try it
Request
GET /api/v1/smartcar/vin-lookup
Response
// Enter an email to see linked VINs

SmartCar Compliance Sync

Pulls live vehicle data from SmartCar, updates the vehicle record, ingests compliance signals, and recomputes the health score — all in one call.

GET /api/v1/fleet/vehicles/{vin}/smartcar-compliance

Request Parameters

ParameterTypeRequiredDescription
vinstringYesPath param. 17-character VIN to sync SmartCar compliance data for.

Example Request

curl -X GET "https://dev.api.aiadmin.quickmechs.com/api/v1/fleet/vehicles/1HGCM82633A004352/smartcar-compliance" \
  -H "Authorization: Bearer YOUR_API_KEY"
Try it
The vehicle must have an active SmartCar connection in the system.
What this syncs:
Odometer / MileageAlways
System Status (ABS, etc.)Admin Enabled
Engine Oil LifeAdmin Enabled
Diagnostic Codes (DTCs)Admin Enabled
Request
GET /api/v1/fleet/vehicles/{vin}/smartcar-compliance
Response
// Enter a VIN to sync SmartCar data