API Limits

​

Billing

​

BILLING : VEHICLE_REQUEST_LIMIT

This is where, for example, you have been allocated 500 api calls / vehicle / month, but you made the 501^st to a single vehicle during a billing period. If you are still in development and are on a Scale or Enterprise plan, please reach out to support@smartcar.com and we’ll work with you to raise these limits while you are still testing.

​

BILLING : VEHICLE_LIMIT

You have exceeded you allocated number of connected vehicles. Please disconnect some vehicles and reach out to support@smartcar.com to clear the violation.

​

Rate Limit

​

RATE_LIMIT : SMARTCAR_API

Your application is making too frequent requests to Smartcar. By default you have a bucket of 120 requests that refills at a rate of 2 requests per minute i.e. you could open 120 connections to Smartcar, but would need to wait 30 seconds to open up the 121^st. If you think you should be allowed to make more frequent requests please reach out to support@smartcar.com or your dedicated Customer Success Manager and we’ll help resolve the issue!

​

RATE_LIMIT : VEHICLE

As of March 2023, Smartcar has a per vehicle rate limit in place to prevent excessive vehicle requests that could:

• Lead to 12v battery drain
• Trigger UPSTREAM:RATE_LIMIT errors that prevent you from making requests for a longer period of time.
• Overwhelm a vehicle’s telematics unit leading to more frequent UPSTREAM errors.

Please see the retry-after header (seconds) for when to retry the request.

​

UPSTREAM : RATE_LIMIT

We’ll return this error if you hit an OEM’s rate limit. For the best coverage we recommend polling once every 30 mins across all brands.