This page describes the types of errors returned by the API, along with troubleshooting suggestions.
| HTTP Status | Code | Explanation |
|---|---|---|
| 401 | Unauthorized (In some cases, there might be a HTTP status with no code.) | Authorization token may be invalid or expired. To troubleshoot, request a new token through the Authentication endpoint. |
| 401 | invalid_client | Client authentication failed due to unknown client, no client authentication included, or unsupported authentication method. To troubleshoot, check that client ID and secret are correct. |
| 401 | invalid_request | The request is missing a required parameter, includes an unsupported parameter value, or is otherwise malformed. To troubleshoot, check that all required parameters are included in the request. |
| 401 | region_not_found | One of the lat/lng coordinates is incorrect. To troubleshoot, check that all lat/lng coordinates are located in your region. |
| 400 | invalid_payment_method | The request contains a payment method that is not valid. |
| 400 | invalid_vehicle_type | The vehicle type in the request is not valid, or not available in your country. |
| 400 | not_enough_locations_to_get_a_quote | The params for the request need to include pickup (object) and destinations (array). |
| 400 | order_pickup_time_must_be_in_the_future | The scheduled_at time is not valid, because it is not in the future. |
| 400 | pickup_and_dropoff_cannot_be_the_same | The lat/lng of the pickup and dropoff location are the same. Input a different value for one of the locations. |
| 400 | prepaid_wallet_insufficient_balance | The order price is greater than the amount in your account's prepaid_wallet. To troubleshoot, add more funds to your prepaid_wallet. |
| 400 | invalid_order_parameters | The contact phone extension needs to include digits only. There may be other invalid parameters that caused this error, please contact us. |
| 403 | Forbidden | One of the contact phone numbers is suspended. |