HTTP Response Codes

Standard HTTP response codes are used to indicate the success or failure of an API request. Each response code provides information about the status of the request.

Successful Response

200 – OK
The request was successfully processed.

Client Error Responses

400 – Bad Request
The request parameters are invalid or failed validation.

401 – Unauthorized / Expired
Authentication failed or the access token has expired.

402 – Insufficient Funds
The account does not have sufficient balance to process the request.

403 – Unauthenticated Request
The request is not properly authenticated.

404 – Not Found
The requested resource or endpoint could not be found.

405 – Method Not Allowed
The HTTP method used is not supported for this endpoint.

415 – Unsupported Media Type
The request content type is not supported.

422 – Unprocessable Entity
The request failed due to invalid or incorrect details.

429 – Too Many Requests
Too many requests were sent in a given time period (rate limit exceeded).

Server Error Responses

500 – Internal Server Error
An unexpected error occurred on the server.

503 – Service Unavailable
The backend system is down or under maintenance.

Response Body Structure

In addition to the HTTP status code, the API returns a structured JSON response in the response body.

Each response contains the following fields:

Field Name	Data Type	Description
code	Integer	HTTP status code returned by the API
status	String	Indicates success or error
message	String	Description of the response or error
request_id	String	Unique identifier for tracking the request
response	Array / Object / Null	Contains actual API data (null in case of errors)

Sample JSON Error Response

{
  "code": 404,
  "status": "error",
  "message": "Resource not found",
  "request_id": "",
  "response": null
}