---
updatedAt: 2025-11-10T23:56:16.000Z
agentTools:
  projectIndex: https://docs.interswitchgroup.com/llms.txt
---

# HTTP Status codes & descriptions

Interswitch's APIs are Restful and as such follow standard HTTP response codes for successful or failed transactions.

| Error                | Description                                                                                                                                                                                                                                   |
| -------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| 200, 201, or 202     | This means the request was successful and the action has been carried out. Also note, we will always send a 200,201 or 202 if the intended action is accepted, completed or verified.                                                         |
| 400                  | A validation error occurred, the request was not completed. This means a parameter to complete this request is unavailable or invalid in the request payload. Kindly check and try again.                                                     |
| 401                  | This can be triggered by passing an invalid secret key in the authorization header or in a scenario where there is none. The request will not be authorized as your request does not fulfill the basic requirement for a successful API call. |
| 404                  | In essence, your request could not be fulfilled as the resource/institution requested does not exist. Please validate the resource requested in this case as this should not happen.                                                          |
| 500, 501,502,503,504 | This request could not be completed due to an error at Interswitch's end. Ordinarily, this should not happen however please, report if you encounter any instance of this kind.                                                               |