/login

✅ Email as user_id

These are the possible response codes when you make an API call to the /login endpoint with an email address as user_id.

Response code

Error

Message

Scenario

Resolution

getaddrinfo ENOTFOUND

Invalid environment value and region in URL

Enter the correct environment ID and region in URL

200 OK

authorization_code value

Successfully logged in using email

200 OK

authorization_code value

Missing redirect_uri value

200 OK

authorization_code value

Missing scope value

200 OK

authorization_code value

Missing locale value

200 OK

authorization_code value

Removed locale value

400 Bad Request

invalid_domain

Invalid API usage

Invalid environment ID in URL

Ensure that the environment ID in the URL / API call is correct.

400 Bad Request

http_exception

"Invalid json format"

Empty payload

Add the payload.

400 Bad Request

invalid_parameters

"Invalid json format"

Invalid JSON format used in the payload.

Use correct JSON format for the payload.

401 Unauthorized

http_exception

Unauthorized

Logged in using unregistered User email and password

Use a registered user email and password.

401 Unauthorized

http_exception

Unauthorized

Enter an invalid/not existing email address

Enter a valid and existing email address

403 forbidden

forbidden

Logged in user without access for resource code

Ensure that the user is allowed to access the resource.

403 Forbidden

forbidden

Entered an invalid client_id or not existent

Enter a valid, existing client_id.

422 Unprocessable Entity

unverified_user

unverified user account

Logged in using unverified account

Check if the email address is verified, if not, have the user go through proper verification

422 Unprocessable Entity

invalid_parameters

"client_id": { "missing': "required" }

**No error description

Missing client_id

Add the client_id value

422 Unprocessable Entity

invalid_parameters

"error_details": {
"client_id": "field required"
}

**No error description"

Removed client_id parameter

Add the client_id parameter and value.

422 Unprocessable Entity

invalid_parameters

"auth_type": {
"invalid": "unsupported auth_type value"
}

Missing auth_type

Add the client_id value

422 Unprocessable Entity

invalid_parameters

{
"redirect_uri": "field required"
}

Removed redirect_uri parameter

Add the client_id parameter and value.

422 Unprocessable Entity

invalid_parameters

{
"grant_type": "field required"
}

Missing grant_type value

Add the grant_type value.

422 Unprocessable Entity

invalid_parameters

"{
"grant_type": "field required"
}"

Removed grant_type parameter

Add the grant_type parameter and value.

422 Unprocessable Entity

invalid_parameters

"user_id": {
"missing": "required"
}"

Did not enter email address

Enter the email address as user_id value.

422 Unprocessable Entity

invalid_parameters

{
"user_id": "field required"
}"

Removed user_id parameter

Add the user_id parameter and value.

422 Unprocessable Entity

invalid_parameters

"error_details": {
"currentPassword": {
"missing": "field required"
}

**No error description"

Missing password value

Enter the password value.

422 Unprocessable Entity

invalid_parameters

"error_details": {
"password": "field required"
}

Removed password parameter

Add the password parameter and value.

422 Unprocessable Entity

invalid_form_fields

{
"signInForm": [
"Too many failedogin attempts. Please try again later."
]

"error_description": "some inputs are invalid"

Too many login attempts

Limit your requests to within the rate limit of the client or environment.

✅ Mobile phone number as user_id

These are the possible response codes when you make an API call to the /login endpoint with an mobile phone number as user_id.

Response code

Error

Message

Scenario

Resolution

getaddrinfo ENOTFOUND

"Could not send request"

Invalid environment in URL

Enter the correct environment ID in the URL.

200 OK

authorization_code value

Logged in successfully using mobile phone number

200 OK

authorization_code value

Missing value for redirect_uri

200 OK

authorization_code value

Missing value for locale field

200 OK

authorization_code value

Removed locale parameter

400 Bad Request

invalid_domain

Invalid API usage

Invalid environment ID

Use the correct environment ID.

401 unauthorized

http_exception

Unauthorized

Logged in using unregistered mobile number as user_id

Use a registered mobile number.

401 unauthorized

http_exception

Unauthorized

Logged in using unverified mobile phone number

Use a verified mobile phone number.

401 Unauthorized

http_exception

Unauthorized

Missing value for scope field

Enter the scope value.

401 Unauthorized

http_exception

Unauthorized

Removed scope parameter

Add the scope parameter.

401 Unauthorized

http_exception

Unauthorized

Invalid user_id - alphanumeric value

Use a valid user_id value.

401 Unauthorized

http_exception

Unauthorized

Missing value for locale field

Enter a valid locale value.

401 Unauthorized

http_exception

Unauthorized

Removed scope parameter

Add the scope parameter and value.

401 Unauthorized

http_exception

Unauthorized

Invalid user_id - alphanumeric value

Use a valid user_id value.

403 Forbidden

http_exception

Forbidden

Invalid client_id value

Use a valid client_id value8.

422 Unprocessable Entity

invalid_parameter

"client_id": {
"missing": "required"
}

**No error description

Missing value in client_id

Enter a valid client_id value.

422 Unprocessable Entity

invalid_parameters

"error_details": {
"client_id": "field required"
}"

Removed client_id parameter

Add the client_id parameter and value.

422 Unprocessable Entity

invalid_parameters

"auth_type": {
"invalid": "unsupported auth_type value"
}

**no error description

Missing auth_type value

Enter the auth_type value.

422 Unprocessable Entity

invalid_parameters

"auth_type": "field required"

Removed auth_type paramater

Add the auth_type parameter and value.

422 Unprocessable Entity

invalid_parameters

"error_details": {
"redirect_uri": "field required"
}

Removed redirect_uri parameter

Add the redirect_uri parameter and value.

422 Unprocessable Entity

invalid_parameters

"grant_type": {
"invalid": "invalid value"
}

**No error description

Missing value for grant_type

Enter the grant_type value.

422 Unprocessable Entity

invalid_parameters

{
"grant_type": "field required"
}

Removed grant_type parameter

Add the grant_type parameter and value.

422 Unprocessable Entity

invalid_parameters

"user_id": {
"missing": "required"
}

**No error description

Missing value for user_id

Enter the user_id value.

422 Unprocessable Entity

invalid_parameters

"user_id": "field required"
}

Removed user_id parameter

Add the user_id parameter and value.

422 Unprocessable Entity

invalid_parameters

"error_details": {
"password": "field required"
}

Removed password parameter

Add password parameter and value.

422 Unprocessable Entity

invalid_parameters

"user_id": {
"missing": "required"
}

**No error description

Missing value for user_id

Enter the user_id value.

422 Unprocessable Entity

invalid_parameters

"user_id": "field required"
}

Removed user_id parameter

Add the user_id parameter and value.

422 Unprocessable Entity

invalid_form_fields

{
"signInForm": [
"Too many failed login attempts. Please try again later."
]

"error_description": "some inputs are invalid"

Too many login attempts

Limit your requests to within the rate limit of the client or environment.

502 Bad gateway

**Configuration issue only

Logged in using a self registration account in demo app

502 Service Temporarily Unavailable

Backend action does not exist

Invalid version

Use the correct version.