Errors

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.