Error Code Glossary
Standard Error Codes
Please see below all error codes listed in detail. In general, a standard 4xx error indicates a bad request, whereas 5xx indicates a server problem. In case of a 4xx error, please check the error code glossary and for 5xx you may retry again later or contact support@caruso-dataplace.com.
HTTP Code |
ReasonCode |
ReasonText | Additional Explanation |
|---|---|---|---|
400 |
CAR.400 |
Bad request, please conform to the API specification. | |
| Bad request, mandatory header parameter {} is missing. | {} = [‘X-Api-Key’, ‘X-Subscription-Id’] | ||
| Bad request, please provide a non empty list of {}. | {} = [‘Vehicles’ , ‘DataItems’] | ||
| Bad request, unsupported api version {}. | {} = given Api version | ||
| Items {} are not covered by subscription or incorrect names provided. | {} = not covered/wrong item names - comma separated | ||
| Bad request, maximum number of vehicles {} exceeded. | {} = currently configured MAX_LIMIT(10) | ||
| Bad request, subscription not found. | |||
401 |
CAR.401 |
Unauthorized request, invalid API key. | Authentication failure |
| Unauthorized request, IP not whitelisted. | Authorization failure | ||
403 |
CAR.403 |
Request is outside of subscription validity. | Authorization failure |
429 |
CAR.429 |
Request limit exceeded for this plan. | |
500 |
CAR.500 |
Internal service failure occured. Please try again later. | |
502 |
CAR.502 |
Communication problem with the provider occured. Please try again later. |
Custom Error Codes
These errors are embedded in a response body with standard code 200 OK.
Vehicle Error Codes
Code |
Message | Additional Explanation |
|---|---|---|
CAR.VE.901 |
Incorrect VIN format. | |
CAR.VE.902 |
Vehicle indentifier type {} not supported.` | The only supported indentifier is VIN |
CAR.VE.903 |
The vehicle is not registered or the vehicle is not telematics/connected service capable. | |
CAR.VE.904 |
The vehicle is black listed. | |
CAR.VE.905 |
Consent not provided by the car owner. | |
CAR.VE.906 |
Request limit exceeded for the vehicle. | |
CAR.VE.907 |
Unexpected error on provider side, data can not be retrieved. | |
CAR.VE.908 |
No data returned by the provider. | |
CAR.VE.909 |
Internal server problem occurred, please try again later. | |
CAR.VE.910 |
Vehicle activation is pending, please try again later. | |
CAR.VE.911 |
Vehicle activation required. | |
CAR.VE.999 |
Unidentified vehicle error. Please contact the support with your transaction id. | Unexpected Error |
Data Item Error Codes
Code |
Message | Additional Explanation |
|---|---|---|
CAR.DE.100 |
Unidentified vehicle error. Please contact the support with your transaction id. | Unexpected Error |
CAR.DE.101 |
Wrong item name, please conform to the data catalog. | |
CAR.DE.102 |
Item not covered by subscription. | |
CAR.DE.103 |
Received incompatible value from the provider. | |
CAR.DE.104 |
No data returned by the provider. | |
CAR.DE.105 |
Item is not supported for polling. |