HTTP 400 — Bad Request

This response is returned when the request is invalid or cannot be processed.

The response includes a list of errors, where each error contains:

• code: A unique identifier for the error
• message: A description of the issue

Possible reasons include:

• Missing or invalid input values
• Incorrect request format
• Invalid email or phone number
• Invalid approval limit values
• Missing required identifiers
• Customer not found or access not allowed
• Issues while processing the request

Common error codes: SIG_FULLNAME_REQUIRED, SIG_EMAIL_REQUIRED, SIG_EMAIL_INVALID, SIG_PHONE_REQUIRED, SIG_PHONE_INVALID, SIG_APPROVALLIMIT_MIN, SIG_APPROVALLIMIT_INVALID, SIG_PARTNERID_REQUIRED, SIG_CUSTOMER_NOTFOUND, SIG_CUSTOMERACCESS_DENIED, SIG_VALIDATION_ERROR, SIG_SERVICECALL_FAILED, SIG_SIGNATORYNOTFOUND, PHONE_SERVICECALL_FAILED

Note:

• Some scenarios such as "not found" or "access denied" may still return HTTP 400.

HTTP 401 — Unauthorized

This response is returned when authentication is missing or invalid.

The response includes:

• code: A standard error identifier
• message: A message indicating that authorization is required

HTTP 403 — Forbidden

This response is returned when the request is understood but not allowed.

The response includes:

• code: A standard error identifier
• message: A message indicating that access is denied

Note:

• This is different from request validation errors, which return HTTP 400.

HTTP 500 — Internal Server Error

This response is returned when an unexpected error occurs while processing the request.

The response includes:

• code: A standard error identifier
• message: A general message describing the failure

Note:

• Errors related to invalid input or request data will return HTTP 400, not 500.