> ## Documentation Index
> Fetch the complete documentation index at: https://smartcar.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Upstream Errors

> Thrown when the OEM servers or vehicle failed to process the request.

<Info>
  <b>Check Smartcar Reliability & Status</b><br />
  For up-to-date information on Smartcar's platform and brand reliability, visit our:

  <ul>
    <li><a href="https://brandreliability.smartcar.com/" target="_blank" rel="noopener">Brand Reliability page</a></li>
    <li><a href="https://status.smartcar.com/" target="_blank" rel="noopener">Platform Status page</a></li>
  </ul>
</Info>

# `INVALID_DATA`

One of Smartcar’s upstream sources provided data that is malformed, invalid, or logically invalid (e.g. 65535 psi for tire pressure).

```json INVALID_DATA theme={null}
{
  "errors": [
    {
      "status": "502",
      "type": "UPSTREAM",
      "code": "INVALID_DATA",
      "title": "Bad Gateway",
      "detail": "Smartcar received invalid data from an upstream source. Please retry your request at a later time.",
      "links": {
        "about": "https://smartcar.com/docs/errors/api-errors/upstream-errors#invalid-data",
      },
      "resolution": { "type": "RETRY_LATER" },
      "suggestedUserMessage": "Your car is temporarily unable to connect to <app name>. Please be patient while we're working to resolve this issue.",
    },
  ]
}
```

### Suggested resolution

You can resolve this error by retrying your request at a later time.

### Suggested user message

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

***

# `KNOWN_ISSUE`

Smartcar received an error from an upstream source. This error usually occurs when an upstream source experiences an error that we have previously investigated and categorized as a known issue.

```json KNOWN_ISSUE theme={null}
{
  "errors": [
    {
      "status": "502",
      "type": "UPSTREAM",
      "code": "KNOWN_ISSUE",
      "title": "Bad Gateway",
      "detail": "Smartcar received an error from an upstream source. Please retry your request at a later time.",
      "links": {
        "about": "https://smartcar.com/docs/errors/api-errors/upstream-errors#known-issue",
      },
      "resolution": { "type": "RETRY_LATER" },
      "suggestedUserMessage": "Your car is temporarily unable to connect to <app name>. Please be patient while we're working to resolve this issue.",
    },
  ]
}
```

### Suggested resolution

You can resolve this error by retrying your request at a later time.

### Suggested user message

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

***

# `NO_RESPONSE`

One of Smartcar’s upstream sources failed to respond. This error usually occurs when one of Smartcar’s upstream sources is experiencing issues and is currently unavailable.
This error can also occur when a specific vehicle in located in an area with weak cellular reception and fails to respond to your request in a timely manner.

```json NO_RESPONSE theme={null}
{
  "errors": [
    {
      "status": "502",
      "type": "UPSTREAM",
      "code": "NO_RESPONSE",
      "title": "Bad Gateway",
      "detail": "One of Smartcar’s upstream sources failed to respond. Please retry your request at a later time.",
      "links": {
        "about": "https://smartcar.com/docs/errors/api-errors/upstream-errors#no-response",
      },
      "resolution": { "type": "RETRY_LATER" },
      "suggestedUserMessage": "Your car is temporarily unable to connect to <app name>. Please be patient while we're working to resolve this issue.",
    },
  ]
}
```

### Suggested resolution

You can resolve this error by retrying your request at a later time.

### Suggested user message

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

***

# `RATE_LIMIT`

Your application’s requests have exceeded this vehicle’s rate limit.

```json RATE_LIMIT theme={null}
{
  "errors": [
    {
      "status": "502",
      "type": "UPSTREAM",
      "code": "RATE_LIMIT",
      "title": "Bad Gateway",
      "detail": "Your application’s requests have exceeded this vehicle’s upstream rate limit. Please retry your request at a later time.",
      "links": {
        "about": "https://smartcar.com/docs/errors/api-errors/upstream-errors#rate-limit",
      },
      "resolution": { "type": "RETRY_LATER" },
      "suggestedUserMessage": "Your car is temporarily unable to connect to <app name>. Please be patient while we're working to resolve this issue.",
    },
  ]
}
```

### Suggested resolution

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

### Suggested user message

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

***

# `UNKNOWN_ISSUE`

Smartcar received an unknown error from an upstream source. This error usually occurs when one of Smartcar’s upstream sources experiences an error that we have not yet investigated or mitigated.

There are several reasons why we might not have investigated this error yet:

* The feature or vehicle make is still in beta.
* This error does not occur very frequently.
* This is the first time we have received this error.

```json UNKNOWN_ISSUE theme={null}
{
  "errors": [
    {
      "status": "502",
      "type": "UPSTREAM",
      "code": "UNKNOWN_ISSUE",
      "title": "Bad Gateway",
      "detail": "Smartcar received an unknown error from an upstream source. Please retry your request at a later time and contact us if the issue persists.",
      "links": {
        "about": "https://smartcar.com/docs/errors/api-errors/upstream-errors#unknown-issue",
      },
      "resolution": { "type": "RETRY_LATER" },
      "suggestedUserMessage": "Your car is temporarily unable to connect to <app name>. Please be patient while we're working to resolve this issue.",
    },
  ]
}
```

### Suggested resolution

Given the broad range of situations that can cause this error, you might or might not be able to resolve this error by retrying your request at a later time.
If you retry your request and the issue persists, please contact us to help you mitigate this error.

### Suggested user message

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

***