Connect Errors

Error Type	Error Code	Description
Access Denied	access_denied	This error occurs when a user denies your application access to the requested scope of permissions.
Invalid Subscription	invalid_subscription	This error occurs when a user’s vehicle is compatible but their connected services subscription is inactive or never activated.
Configuration Error	configuration_error	This error occurs when the user has encountered an Error page in Connect and has chosen to return to your application.
No Vehicles	no_vehicles	This error occurs when a vehicle owner has a connected services account, but there are no vehicles associated with the account.
Vehicle Incompatible	vehicle_incompatible	This error occurs when a user tries to authorize an incompatible vehicle in Smartcar Connect.
Server Error	server_error	If there is a server error, the user will return to your application.

API Errors

API errors are returned from requests made via Smartcar API. Smartcar uses HTTP status codes to indicate success or failure of API requests. This includes:

2XX: indicates success
4XX: indicates an invalid request (e.g. a required parameter is missing from the request body)
5XX: indicates Smartcar-related issues (e.g. a vehicle is not capable of fulfilling a request).

Error Response

All Smartcar errors contain the following fields:

Name	Type	Description
type	string	A unique identifier that groups codes into broad categories of errors
code	string	A short, descriptive identifier for the error that occurred
title	string	A human readable representation of the code
detail	string	A short description of the code that provides additional information about the error. Always provided in English.
status	number	The HTTP status code (In long running commands, may differ from http response header)
resolution	object	An object with at least one enumerated property named as “type” that specifies which action can be taken to resolve this error. There are three possible values for the property “type”: `RETRY_LATER` - Retry the request at a later time; `REAUTHENTICATE` - Prompt the user to re-authenticate in Smartcar Connect; and `CONTACT_SUPPORT` - Contact Smartcar’s support team. This object could contain other properties depending on the “type” of error.
suggestedUserMessage	object	A friendly message to describe transient errors to application users
links	object	Links to error documentation
meta	object	Contains debugging information useful when contacting customer support

Error Type	Error Code	Status	Description
`AUTHENTICATION`	UNAUTHORIZED	401	Thrown when there is an issue with your authorization headers.
`AUTHENTICATION`	ACCESS_DENIED	403	Thrown when the presented token does not have access to the requested resource.
`BILLING`	INVALID_PLAN	430	Thrown when limits have been reached based on your plan or if the feature is not available.
`BILLING`	VEHICLE_LIMIT	430	Thrown when limits have been reached based on your plan or if the feature is not available.
`BILLING`	VEHICLE_REQUEST_LIMIT	430	Thrown when limits have been reached based on your plan or if the feature is not available.
`BILLING`	ACCOUNT_SUSPENDED	430	Thrown when limits have been reached based on your plan or if the feature is not available.
`COMPATIBILITY`	MAKE_NOT_COMPATIBLE	501	Thrown when Smartcar does not support a make or feature for a vehicle.
`COMPATIBILITY`	SMARTCAR_NOT_CAPABLE	501	Thrown when Smartcar does not support a make or feature for a vehicle.
`COMPATIBILITY`	VEHICLE_NOT_CAPABLE	501	Thrown when Smartcar does not support a make or feature for a vehicle.
`COMPATIBILITY`	PLATFORM_NOT_CAPABLE	501	Thrown when the OEM integration does not support this endpoint. The vehicle owner may need to reauthenticate.
`CONNECTED_SERVICES_ACCOUNT`	ACCOUNT_ISSUE	400	Thrown when there are issues with the user’s connected service account.
`CONNECTED_SERVICES_ACCOUNT`	AUTHENTICATION_FAILED	400	Thrown when there are issues with the user’s connected service account.
`CONNECTED_SERVICES_ACCOUNT`	NO_VEHICLES	400	Thrown when there are issues with the user’s connected service account.
`CONNECTED_SERVICES_ACCOUNT`	SUBSCRIPTION	400	Thrown when there are issues with the user’s connected service account.
`CONNECTED_SERVICES_ACCOUNT`	VEHICLE_MISSING	400	Thrown when there are issues with the user’s connected service account.
`CONNECTED_SERVICES_ACCOUNT`	PERMISSION	400	Thrown when there are permission issues with the user’s connected service account.
`CONNECTED_SERVICES_ACCOUNT`	VIRTUAL_KEY_REQUIRED	400	Thrown when a virtual key is required to complete the request.
`RATE_LIMIT`	SMARTCAR_API	429	Thrown when there is an issue with the frequency of your requests.
`RATE_LIMIT`	VEHICLE	429	Thrown when there is an issue with the frequency of your requests.
`RESOURCE_NOT_FOUND`	PATH	404	Thrown if the requested path does not exist.
`RESOURCE_NOT_FOUND`	VERSION	404	Thrown if the requested path does not exist.
`SERVER`	INTERNAL	500	Thrown when Smartcar runs into an unexpected issue and was unable to process the request.
`SERVER`	MULTIPLE_RECORDS_FOUND	500	Thrown when multiple records are found but only one was expected.
`SERVER`	RECORD_NOT_FOUND	500	Thrown when a required record could not be found.
`UPSTREAM`	INVALID_DATA	502	Thrown when the OEM or vehicle failed to process the request.
`UPSTREAM`	KNOWN_ISSUE	502	Thrown when the OEM or vehicle failed to process the request.
`UPSTREAM`	NO_RESPONSE	502	Thrown when the OEM or vehicle failed to process the request.
`UPSTREAM`	RATE_LIMIT	502	Thrown when the OEM or vehicle failed to process the request.
`UPSTREAM`	UNKNOWN_ISSUE	502	Thrown when the OEM or vehicle failed to process the request.
`VALIDATION`	INVALID_INPUT_FORMAT	400	Thrown if there is an issue with the format of the request or body.
`VEHICLE_STATE`	ASLEEP	409	Thrown when a request fails due to the state of a vehicle or logically cannot be completed—for example, you can’t retrieve vehicle data because the vehicle is asleep and not responding to network requests.
`VEHICLE_STATE`	CHARGING_IN_PROGRESS	409	Thrown when a request fails due to the state of a vehicle or logically cannot be completed—for example, you can’t unlock the charge port while the vehicle is actively charging.
`VEHICLE_STATE`	CHARGING_PLUG_NOT_CONNECTED	409	Thrown when a request fails due to the state of a vehicle or logically cannot be completed—for example, you can’t start charging the vehicle if the cable is not plugged in.
`VEHICLE_STATE`	DOOR_OPEN	409	Thrown when a request fails due to the state of a vehicle or logically cannot be completed—for example, you can’t lock the vehicle if a door is open.
`VEHICLE_STATE`	FULLY_CHARGED	409	Thrown when a request fails due to the state of a vehicle or logically cannot be completed—for example, you can’t start charging because the battery is already fully charged.
`VEHICLE_STATE`	NOT_CHARGING	409	Thrown when a request fails due to the state of a vehicle or logically cannot be completed—for example, you can’t stop charging because the vehicle is not currently charging.
`VEHICLE_STATE`	CHARGE_FAULT	409	Thrown when a request fails due to the state of a vehicle or logically cannot be completed—for example, you can’t start charging because the vehicle has detected a charging system fault.
`VEHICLE_STATE`	HOOD_OPEN	409	Thrown when a request fails due to the state of a vehicle or logically cannot be completed—for example, you can’t start the engine if the hood is open.
`VEHICLE_STATE`	IGNITION_ON	409	Thrown when a request fails due to the state of a vehicle or logically cannot be completed—for example, you can’t perform certain remote actions while the ignition is on.
`VEHICLE_STATE`	IN_MOTION	409	Thrown when a request fails due to the state of a vehicle or logically cannot be completed—for example, you can’t lock the doors while the vehicle is in motion.
`VEHICLE_STATE`	REMOTE_ACCESS_DISABLED	409	Thrown when a request fails due to the state of a vehicle or logically cannot be completed—for example, you can’t send remote commands because remote access is disabled in the vehicle settings.
`VEHICLE_STATE`	TRUNK_OPEN	409	Thrown when a request fails due to the state of a vehicle or logically cannot be completed—for example, you can’t lock the vehicle if the trunk is open.
`VEHICLE_STATE`	UNKNOWN	409	Thrown when a request fails due to the state of a vehicle or logically cannot be completed—for example, the vehicle reports an unknown state that prevents the requested action.
`VEHICLE_STATE`	UNREACHABLE	409	Thrown when a request fails due to the state of a vehicle or logically cannot be completed—for example, you can’t send commands because the vehicle is offline or out of network range.
`VEHICLE_STATE`	VEHICLE_OFFLINE_FOR_SERVICE	409	Thrown when a request fails due to the state of a vehicle or logically cannot be completed—for example, you can’t access vehicle data because the vehicle is offline for maintenance or service.

Introduction

Authorization

Connections

Webhooks

Vehicle Data

Vehicle Commands

Compatibility

API 2.0 Reference (Legacy)

Vehicle Commands (Legacy)

Management API (Legacy)

Compatibility API (Legacy)

Errors Overview

Connect Errors

API Errors

Error Response

​Connect Errors

​API Errors

​Error Response

Connect Errors

API Errors

Error Response