​
200 - OK

  • What does it mean?
The request has succeeded and our servers have returned the expected data.
  • What should I do?

No action required. You can proceed to use the data returned by our API in your application or process.

​
400 - Generic Error

  • What does it mean?
The request could not be understood by the SKULabs servers due to a malformed request or data validation errors.
  • What should I do?

Review your request to ensure all parameters are correct and conform to the API specifications. Check our API documentation for required data formats and types. Resend your request after you’ve made corrections.

​
401 - Not Authorized

  • What does it mean?
The request has not been fulfilled because it lacks valid authentication credentials.
  • What should I do?

Ensure your API keys or authentication credentials are correctly included in your request headers. Generate an API key if you haven’t already.

If you’ve already generated an API key, make sure you are passing it correctly in the request headers.

If you continue to face issues, confirm that the credentials have not expired and are still valid for accessing our API.

​
403 - Missing Permissions

  • What does it mean?
The authenticated user does not have permission to perform a specific action or request.
  • What should I do?

Check the permissions associated with your API credentials. You may need to request additional permissions or roles from an administrator on your SKULabs account. Verify that your API keys are correctly configured for the required scope of actions.

​
429 - Too Many Requests

  • What does it mean?
The request cannot be served due to the rate limit being exceeded.
  • What should I do?

Slow down your request rate to the API and respect the rate limits that are documented in the rate limit documentation. Implement an exponential backoff algorithm to ensure your IP does not get banned.

​
502 - Bad Gateway

  • What does it mean?
The authenticated user does not have permission to perform a specific action or request.
  • What should I do?

This error is typically a problem on the server side, not an issue with your request. Wait a few moments and then resend your request. If the problem persists, contact SKULabs support for assistance.

​
Retryable endpoints

For any retryable endpoint, pass a “Retry-Token” parameter with a unique and random MongoDB ObjectID.

​
202 - Accepted

  • What does it mean?
Your request was received but not yet processed.
  • What should I do?

Please check back at URI provided in the response error.data.retryUrl (/retryable/get?retry_token=X) for the completed request.

​
203 - Non-authoritative Information

  • What does it mean?
This is a saved response from the original request, meaning it may not be up-to-date.
  • What should I do?

With this response code, you should be aware that the information provided in the response might not be the most up-to-date or accurate representation of the resource, and further verification may be necessary.

Rate LimitsQuerying Data