If your CleverTap API request fails, you will receive an error response including a response code and a message explaining the reason for the error.

Generic Error Codes

The following response code pattern applies across CleverTap API requests:

2xx Success Codes

2xx codes indicate that the request was successfully processed. The following are the most common 2xx status codes:

Status Code	Text	Description
200	OK	The request has been successfully processed.
201	Created	The request has been fulfilled and has resulted in one or more new resources being created.
202	Accepted	The request has been accepted for processing, but the processing has not been completed.
204	No Content	The request has been successfully fulfilled by the server and there is no additional content to send in the response payload body.

4xx codes indicate that there was an error in either the request or the data. The following are the most common 4xx status codes:

Status Code	Text	Description
400	Bad Request	Invalid parameter passed
401	Unauthorized	Invalid credentials or URI
403	Forbidden	Operation not allowed
404	Not Found	Resource does not exist or cannot be found
409	Conflict	Resource already exists
429	Too Many Requests	Rate limit exceeded

5xx codes indicate that there was an internal error with the server. The following are the most common 5xx status codes:

Status Code	Text	Description
500	Internal Server Error	Error within the API
503	Service Unavailable	System is unavailable. Try again later.