# 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. <br>

| 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                                            |