The Authentication API typically returns an HTTP status code of 200 OK regardless of whether or not the API call completes successfully. That means that, in addition to looking at the status code, you must look at the API response to know whether the call really did succeed. If it turns out that the call failed, the API response will look similar to this:

{
  "stat": "error",
  "code": 100,
  "error_description": "missing arguments: flow",
  "error": "missing_argument",
  "request_id": "uyeem84bmqmnjuu4"
}

The following table provides a brief description of the properties found in a typical error message:

Error message property

Description

stat

Status of the operation. Valid values are;

• OK
• Error
• Failed

code

Status code associated with the error. Note that this code isn't a standard HTTP status code.

error_description

Additional information describing the error and why it might have occurred.

error

Type of error that occurred.

request_id

16-character identifier assigned to each error response.

For information about the individual errors and error codes codes associated with this API, see Registration error codes.