Error Code Master

ClearTax uses conventional HTTP response codes to indicate the success or failure of an API request.

Errors can be of two types

1. Invalid or unauthorized request error (4XX)

2. Internal server error (5XX)

The following are the HTTP response codes and their summary.

HTTP Response Code	Summary
200 - OK	Everything worked as expected
201 - CREATED	The task or workflow was created
400 - BAD REQUEST	The request was unacceptable, often due to a missing or invalid required parameter
401 - UNAUTHORIZED	No valid auth token provided
402 - REQUEST FAILED	Parameters were valid but request failed
409 - CONFLICT	The request conflicts with another request (perhaps due to pending workflow)
429 - TOO MANY REQUESTS	Too many requests hit the API too quickly. We recommend an exponential backoff of your requests
500, 502, 503, 504 - SERVER ERRORS	Something went wrong on ClearTax end. These are rare