Three lines




There are various conditions in which the API may return an error. Your app can then parse the error to determine the best next step for the user.

Error responses

The following table provides examples of possible error responses.

HTTP Status Code Meaning
401 unauthorized No authentication provided
422 validation_failed One of the input values is not in the correct format
503 service_unavailable The service is currently unavailable

Error format

Error responses have a consistently formed JSON body. The keys may include:

Field Type Description
code string Machine-readable code for error
message string Human-readable message for error
Sample error

This error is returned whenever an HTTP request is missing the Authorization header for an endpoint that requires a valid acccess_token:

  "code": "unauthorized",
  "message": "No authentication provided."


Our webhook service makes requests to your webhook url and can encounter the following types of errors:

  • SSL Error - The ssl certificate being used does not match the hostname, is expired, or is invalid. You can validate your ssl certificate with SSL Labs.
  • Connect Timeout - The request timed out while trying to connect to the remote server or did not send any data after 10 seconds.
  • Connection Error - A network connection error occurred.
  • Request Exception - There was an ambiguous exception that occurred while handling your request.


© 2023 Uber Technologies Inc.