VALIDATION

Request invalid or malformed. Please check for missing parameters, spelling and casing mistakes, and other syntax issues.

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37
  • 38
  • 39
  • 40
  • 41
  • 42
  • 43
  • 44
  • 45
  • 46
  • 47
  • 48
  • 49
  • 50
{
  "type": "VALIDATION",
  "code": null,
  "description": "Request invalid or malformed. Please check for missing parameters, spelling and casing mistakes, and other syntax issues.",
  "docURL": "https://smartcar.com/docs/errors/v2.0/other-errors/#validation",
  "statusCode": 400,
  "requestId": "5dea93a1-3f79-4246-90c5-89610a20471b",
  "resolution": null
}

Suggested resolution

You can resolve this error by referring to our API reference and ensuring that you pass all the parameters as specified.

Troubleshooting steps

  1. Ensure that you spell and case all parameters correctly.
  2. Ensure that your request has the correct content-type (i.e. application/json or application/x-www-form-urlencoded).
  3. Ensure that your request has the correct URL and HTTP method.

Suggested user message

Your car is temporarily unable to connect to <app name>. Please be patient while we’re working to resolve this issue.

AUTHENTICATION

The authorization header is missing or malformed, or it contains invalid or expired authentication credentials (e.g. access token, client ID, client secret). Please check for missing parameters, spelling and casing mistakes, and other syntax issues.

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37
  • 38
  • 39
  • 40
  • 41
  • 42
  • 43
  • 44
  • 45
  • 46
  • 47
  • 48
  • 49
  • 50
{
  "type": "AUTHENTICATION",
  "code": null,
  "description": "The authorization header is missing or malformed, or it contains invalid or expired authentication credentials. Please check for missing parameters, spelling and casing mistakes, and other syntax issues.",
  "docURL": "https://smartcar.com/docs/errors/v2.0/other-errors/#authentication",
  "statusCode": 401,
  "requestId": "5dea93a1-3f79-4246-90c5-89610a20471b",
  "resolution": null
}

Suggested resolution

You can resolve this error by referring to our API reference and ensuring that you pass all the parameters as specified. If you are certain that your request is well-formed, please try refreshing your access token.

Troubleshooting steps

  1. Refer to our API reference and ensure that you use the correct authentication mechanism for your request.
  2. Check constants like Bearer and Basic for spelling mistakes.
  3. If you make a request to a vehicle endpoint, verify that your access token grants you access to the correct vehicle. You can do so by making a request to the /vehicles endpoint and ensuring that the correct vehicle ID is included in the returned response.
  4. If you have refreshed your access token, make sure that it persists and that you use your new token to make your request.

Suggested user message

Your car is temporarily unable to connect to <app name>. Please be patient while we’re working to resolve this issue.

PERMISSION

Your application has insufficient permissions to access the requested resource. Please prompt the user to re-authenticate using Smartcar Connect.

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37
  • 38
  • 39
  • 40
  • 41
  • 42
  • 43
  • 44
  • 45
  • 46
  • 47
  • 48
  • 49
  • 50
{
  "type": "PERMISSION",
  "code": null,
  "description": "Your application has insufficient permissions to access the requested resource. Please prompt the user to re-authenticate using Smartcar Connect.",
  "docURL": "https://smartcar.com/docs/errors/v2.0/other-errors/#permission",
  "statusCode": 403,
  "requestId": "5dea93a1-3f79-4246-90c5-89610a20471b",
  "resolution": "REAUTHENTICATE"
}

Suggested resolution

You can resolve this error by ensuring that the scope parameter contains all the permissions that your application requires and prompting the user to re-authenticate using Smartcar Connect.

Troubleshooting steps

  1. Ensure that the scope parameter contains all the permissions that your application requires.
  2. Ensure that you spell all permission names in the scope parameter correctly.
  3. Prompt the user to re-authenticate using Smartcar Connect.

Suggested user message

<App name> does not yet have permission to <action> your car. Please use this link to re-connect your car to <app name>: <link to Smartcar Connect>.

Examples for <action>:

    • Read the engine oil life of
    • Read the EV battery capacity of
    • Read the EV battery level of
    • Read the EV charging status of
    • Start charging
    • Stop charging
    • Read the fuel tank level of
    • Locate
    • Lock
    • Unlock
    • Read the odometer of
    • Read the tire pressure from
    • Read the make, model, and year of
    • Read the VIN of

RATE_LIMIT

Your application has exceeded its rate limit. Please retry your request in a few minutes.

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37
  • 38
  • 39
  • 40
  • 41
  • 42
  • 43
  • 44
  • 45
  • 46
  • 47
  • 48
  • 49
  • 50
{
  "type": "RATE_LIMIT",
  "code": "SMARTCAR_API",
  "description": "Your application has exceeded its rate limit. Please retry your request in a few minutes.",
  "docURL": "https://smartcar.com/docs/errors/v2.0/other-errors/#rate_limit",
  "statusCode": 429,
  "requestId": "5dea93a1-3f79-4246-90c5-89610a20471b",
  "resolution": "RETRY_LATER"
}

Suggested resolution

You can resolve this error by refraining from making API requests for a certain period of time. If your application automatically retries requests for certain errors, please disable automatic retries or implement a backoff period to retry certain requests less frequently.

Troubleshooting steps

If you believe that you received this error by mistake and your application didn’t actually exceed its rate limit, please contact us and we’ll be happy to assist you.

Suggested user message

Your car is temporarily unable to connect to <app name>. Please be patient while we’re working to resolve this issue.

INTERNAL

An internal Smartcar error has occurred. Our team has been notified and is working to resolve this issue.

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37
  • 38
  • 39
  • 40
  • 41
  • 42
  • 43
  • 44
  • 45
  • 46
  • 47
  • 48
  • 49
  • 50
{
  "type": "SERVER",
  "code": "INTERNAL",
  "description": "An internal Smartcar error has occurred. Our team has been notified and is working to resolve this issue.",
  "docURL": "https://smartcar.com/docs/errors/v2.0/other-errors/#internal",
  "statusCode": 500,
  "requestId": "5dea93a1-3f79-4246-90c5-89610a20471b",
  "resolution": "RETRY_LATER"
}

Suggested resolution

Please contact us to learn more about the error and our steps to resolve it.

Suggested user message

Your car is temporarily unable to connect to <app name>. Please be patient while we’re working to resolve this issue.

PATH

The requested resource does not exist. Please check the URL and try again.

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37
  • 38
  • 39
  • 40
  • 41
  • 42
  • 43
  • 44
  • 45
  • 46
  • 47
  • 48
  • 49
  • 50
{
  "type": "RESOURCE_NOT_FOUND",
  "code": "PATH",
  "description": "The requested resource does not exist. Please check the URL and try again.",
  "docURL": "https://smartcar.com/docs/errors/v2.0/other-errors/#path",
  "statusCode": 404,
  "requestId": "5dea93a1-3f79-4246-90c5-89610a20471b",
  "resolution": null
}

Suggested resolution

You can resolve this error by referring to our API reference and ensuring that you use the correct URL for your request.

Troubleshooting steps

  1. Ensure that you spell all static parts of the URL correctly.
  2. Ensure that you use the correct URL path parameters (e.g. vehicle ID).
  3. Ensure that you use the correct HTTP method.

Suggested user message

Your car is temporarily unable to connect to <app name>. Please be patient while we’re working to resolve this issue.

VERSION

The requested resource does not exist. Your request either does not specify a version number or it specifies a version number that is not supported by this resource.

  • 1
  • 2
  • 3
  • 4
  • 5
  • 6
  • 7
  • 8
  • 9
  • 10
  • 11
  • 12
  • 13
  • 14
  • 15
  • 16
  • 17
  • 18
  • 19
  • 20
  • 21
  • 22
  • 23
  • 24
  • 25
  • 26
  • 27
  • 28
  • 29
  • 30
  • 31
  • 32
  • 33
  • 34
  • 35
  • 36
  • 37
  • 38
  • 39
  • 40
  • 41
  • 42
  • 43
  • 44
  • 45
  • 46
  • 47
  • 48
  • 49
  • 50
{
  "type": "RESOURCE_NOT_FOUND",
  "code": "VERSION",
  "description": "The requested resource does not exist. Please check your specified version number and try again.",
  "docURL": "https://smartcar.com/docs/errors/v2.0/other-errors/#version",
  "statusCode": 404,
  "requestId": "5dea93a1-3f79-4246-90c5-89610a20471b",
  "resolution": null
}

Suggested resolution

You can resolve this error by referring to our API reference and ensuring that your request specifies the correct version number.

Troubleshooting steps

  1. Ensure that you specify a version number in the URL path (e.g. https://api.smartcar.com/v1.0/vehicles).
  2. Ensure that the given resource supports the version number you specified.

Suggested user message

Your car is temporarily unable to connect to <app name>. Please be patient while we’re working to resolve this issue.