Error codes

Error codes returned across the Full Integration API. The broker's CRM must return the relevant codes for the calls cTrader makes into it. Each endpoint entry links to the codes that apply to it.

Standard HTTP status codes

Status code	Designation	General usage
200	OK	Request successful
400	Bad Request	Invalid request parameters
403	Forbidden	Permission denied
404	Not Found	Resource not found
410	Gone	Resource expired
417	Expectation Failed	Invalid token format

SSO (OAuth) specific error codes

Status	Error code	Cause
400 Bad Request	None	At least one required field is missing or request parameters are malformed: missing query parameters, invalid JSON body, malformed URL parameters or missing broker identification.
403 Forbidden	CH_CLIENT_AUTH_FAILURE	Invalid password when requesting the CRM API token, or invalid crmApiToken in subsequent CRM API calls.
403 Forbidden	CH_INSUFFICIENT_PERMISSIONS	Broker lacks access rights due to manager.disabledBrokerName configuration.
404 Not Found	OT token not found	code not found in broker's backend (Verify and exchange OT token).
404 Not Found	Long-term access token not found	accessToken not found in broker's backend (Verify long-term access token).
404 Not Found	User identifier not found	userId not found in broker's backend (POST /oauth2/onetime/generate).
410 Gone	CID_TOKEN_EXPIRED	Expired token used to access broker's backend.
417 Expectation Failed	CID_NON_EXISTED_TOKEN	Invalid token format used to access broker's backend.