Skip to main content

9. Additional Error Codes

The following table summarises the error codes that may be returned when attempting to verify and exchange an OT token, or validate a long-term access token.

Error CodeCode DesignationCode Explanation
400Bad RequestThis error occurs when at least one required field is not specified.
403ForbiddenError cases:
CH_CLIENT_AUTH_FAILURE occurs when access has been denied to the broker's backend, e.g., when an invalid password is passed in API call 4.1. or an invalid crmApiToken is passed in API calls 4.2-4.4.
CH_INSUFFICIENT_PERMISSIONS occurs when at least one brokerName contained in the specified brokerCrmName lacks access rights because it is listed in manager.disabledBrokerName.
404Not FoundThis error occurs in the following cases:
- The OT token (code) passed in the request body of API call 4.2 is not found by the broker's backend.
- The long-term access token (accessToken) passed in the request body of API call 4.3 is not found by the broker's backend.
- The user identifier (userId) passed in the request body of API call 4.4 is not found by the broker's backend.
410GoneCID_TOKEN_EXPIRED occurs when an expired token is used to access the broker's backend.
417Expectation FailedCID_NON_EXISTED_TOKEN occurs when an invalid token is used to access the broker's backend.