Pricing

Docs

Guides

Testing

Before making a live request to a real vehicle, use our testing framework to test your application.


Smartcar's test mode allows you to use our API on one of our simulated vehicles.

You can test your app on Smartcar without access to a real vehicle - at no cost!

In test mode, you can send API requests to simulated vehicles. Requests to our API will return randomized data.

  1. /odometer returns a random value between 10,000 and 300,000 km
  2. /location returns a random location boxed in Colorado
  3. /security always returns a success status

How to use test mode

  1. When redirecting to Connect, pass in the query parameter mode=test. If you are using an SDK, use the test_mode boolean when instantiating the Smartcar authorization client.
  2. Click on any vehicle brand.
  3. Use any email address (anything@anything.com) with any password to log into a simulated vehicle for the chosen vehicle brand.

Checking vehicle compatibility in test mode

Smartcar's Connect flow offers a VIN-based compatibility check that allows vehicle owners to determine whether or not their car is compatible with your application's requested scope. To test this functionality in the context of your application, Smartcar provides a series of test mode vehicles for you to use. Each vehicle has a specific make, model, year, and unique set of compatible permissions. The VINs correlated to each of these vehicles can be constructed as described below.

Constructing test vehicle VINs

The VIN (vehicle identification number) is a unique code that identifies a vehicle. A VIN consists of 17 alphanumeric characters. Each test VIN is constructed as follows:

  1. The first 3 characters are always 0SC. This symbolizes that it's a Smartcar test vehicle.
  2. The next 6 characters identify the test vehicle. The list of valid identifiers is available below.
  3. the last 8 characters must be randomly generated to pad the rest of the VIN.

Valid identifiers

  • AUDI01 - 2014 Audi A3
  • AUDI02 - 2017 Audi A4
  • AUDI03 - 2019 Audi A6
  • BMW001 - 2015 BMW X1
  • BMW002 - 2016 BMW 740i
  • BMW003 - 2016 BMW i3
  • BMW004 - 2017 BMW i3
  • BMW005 - 2018 BMW 330i
  • GMB001 - 2008 Buick Enclave
  • GMB002 - 2018 Buick LaCrosse
  • GMB003 - 2018 Buick Verano
  • GMCC01 - 2009 Cadillac Escalade
  • GMCC02 - 2017 Cadillac CTS
  • GMCC03 - 2018 Cadillac ATS
  • GMCT01 - 2007 Chevrolet Equinox
  • GMCT02 - 2018 Chevrolet Volt
  • GMCT03 - 2018 Chevrolet Bolt
  • FCAC01 - 2017 Chrysler 300
  • FCAC02 - 2011 Chrysler 200
  • FORD01 - 2016 Ford Fusion
  • FORD02 - 2018 Ford Fusion
  • FORD03 - 2018 Ford Mustang
  • GMC001 - 2010 GMC 200
  • GMC002 - 2017 GMC Yukon
  • GMC003 - 2017 GMC Sierra
  • HYU001 - 2014 Hyundai Elantra
  • HYU002 - 2016 Hyundai Sonata
  • HYU003 - 2018 Hyundai Sonata Plugin Hybrid
  • HYU004 - 2019 Hyundai Ioniq Electric
  • TESLA1 - 2016 Tesla Model S
  • TESLA2 - 2017 Tesla Model X
  • TESLA3 - 2018 Tesla Model 3
  • LEXUS1 - 2014 Lexus IS
  • LEXUS2 - 2017 Lexus IS
  • LEXUS3 - 2017 Lexus ES
  • VW0001 - 2013 Volkswagen Eos
  • VW0002 - 2015 Volkswagen Passat
  • VW0003 - 2016 Volkswagen e-Golf
  • FCAJ01 - 2013 Jeep Wrangler
  • FCAJ02 - 2018 Jeep Compass
  • FCAJ03 - 2018 Jeep Cherokee
  • FCAR01 - 2014 RAM 1500
  • FCAR02 - 2017 RAM 2500
  • FCAR03 - 2018 RAM 3500
  • FCAD01 - 2014 Dodge Journey
  • FCAD02 - 2017 Dodge Challenger
  • FCAD03 - 2018 Dodge Charger