Error Codes

Otonomo uses HTTP response codes to indicate the completion status of an API call.
There are three main groups of response codes:

  1. 2xx success response codes: indicate a successful API call. May also indicate a call for which no new data exists.
  2. 4xx error status codes indicate an error related to the information provided on the API call (e.g., a required parameter is missing)
  3. 5xx error status codes indicate Otonomo server errors.

Error code table:

Response code

Possible reasons

200

  1. The API call is successful
  2. If not data is returned, then one or more mandatory attributes are not available

204

No new data is available

400

Bad request. This error is likely the result of a wrong or missing parameter on an API call. This response code usually includes a body header that indicates the bad parameter (key) and its related issue (value).

401

User credentials or token are not valid. May also result from a lack of driver consent on the OEM side. e.g. when a driver has revoked consent directly on the OEM portal.

403

User is not authorised to query the requested resource. May also result from lack of consent on the OEM side. e.g. when a driver has revoked consent directly on the OEM portal.

404

Bad URL The resource pointed by the URL does not exist.

429

Too many requests. This error is issued when the user has exceeded the API rate limitations. It may also originate from a rate limitation on the data provider side.

500

Internal server error.


Did this page help you?