Skip to main content
All API errors return a consistent JSON structure with a machine-readable code, a human-readable message, a link to relevant documentation, and a requestId to include when reporting issues.
Always include the requestId when contacting support. It helps us trace the exact request on our end.

Error Codes


400 Bad Request

Code: BAD_REQUEST The request was malformed or contained invalid parameters. Check your query parameters, request body, and data types before retrying.

401 Unauthorized

Code: UNAUTHORIZED No valid API key was provided. Make sure you are sending the X-RapidAPI-Key header with every request.
If you are subscribed on RapidAPI but still getting 401s, go to the App tab in the playground and verify your key is correct.

403 Forbidden

Code: FORBIDDEN Your API key is valid but does not have access to this resource. This usually means the endpoint or feature requires a higher plan.

404 Not Found

Code: NOT_FOUND The requested resource does not exist. Double-check the exerciseId or endpoint path.

405 Method Not Allowed

Code: METHOD_NOT_ALLOWED The HTTP method used is not supported for this endpoint. All ascendapi.com GET.

409 Conflict

Code: CONFLICT The request conflicts with the current state of the server.

412 Precondition Failed

Code: PRECONDITION_FAILED This error occurs when your request is valid, but a precondition required to fulfill it is not met. Unlike validation errors where your input is invalid, precondition failures indicate that the system or resource is not configured correctly to handle your request.

429 Too Many Requests

Code: TOO_MANY_REQUESTS You have exceeded the rate limit for your plan. Free plans are limited to 1,000 requests per hour. See Rate Limiting for details.

500 Internal Server Error

Code: INTERNAL_SERVER_ERROR This error occurs when there is an issue with the server. If you have received this error, please contact support immediately. We constantly monitor our servers and will resolve the issue as soon as possible, but sometimes the error you encounter may be due to a temporary issue or we are not aware of if at the moment.

RapidAPI-Specific Errors

When accessing the API through RapidAPI, you may encounter additional error responses returned by the RapidAPI gateway before reaching our servers.

Contact

If you encounter an error that is not listed here or need help debugging, reach out at support@ascendapi.com.
Last modified on March 22, 2026