Response Status Codes
Even with careful requests, errors can occur. The Turuq API returns HTTP status codes to indicate success or the type of failure.
| Code | Meaning | Description |
|---|---|---|
| 200 | Success | The request was successful. Relevant data will be available in the data field of the JSON response. |
| 201 | Created | The request was successful. Relevant data will be available in the data field of the JSON response. |
| 400 | Bad Request | Missing or malformed parameter. Check the documentation and your request, then try again. |
| 401 | Unauthorized | No or invalid API key provided, or the account does not have access to this resource. |
| 403 | Forbidden | Authentication valid but server refuses to fulfill the request (e.g., lack of permissions). |
| 404 | Not Found | The endpoint or resource does not exist. |
| 429 | Too Many Requests | Rate limit exceeded. See the Rate Limits section for details. |
| 500 | Internal Server Error | An unexpected error occurred on Turuq’s side. You may retry, but if it persists, contact support. |
Note: Additional details about errors may be provided in the
messageproperty at the root level of the JSON response body.