Introduction to the Qase API

Welcome to the API! You can use our API to access API endpoints, which allows to retrieve information about entities stored in database and perform actions with them. The API is organized around REST.

You can try using the API on the page API Reference or by getting to know the public page in Postman.

API Rate limits

Your application can make up to 600 API requests per minute.

For Enterprise customers, the limits can be changed.

Once the limit is exceeded, clients receive an HTTP 429 with a Retry-After: X header to indicate how long their timeout period is before they will be able to send requests again. The timeout period is set to 60 seconds once the limit is exceeded.

Authentication uses API tokens to authenticate requests. You can view and manage your API keys in API tokens pages.

Your API keys has the same access rights as your role in the app, so be sure to keep them secure! Do not share your secret API keys in publicly accessible areas such as GitHub, client-side code, and so forth.

Qase API expects for the API key to be included in all API requests to the server in a header that looks like the following:


All API requests must be made over HTTPS. Calls made over plain HTTP will fail. API requests without authentication will also fail.


You must replace API_TOKEN with your personal API key.

Access rights is using Role-based Access Control system to restrict some features usage in Web interface and the same rules are applied to API methods. In description for each method you will find a rule name, that is required to perform an action through API. If you don't have enough access rights, you will receive an error with 403 status code.

Error Codes

400Bad Request - Your request is invalid.
401Unauthorized - Your API key is wrong.
403Forbidden - Your role doesn't have enough permissions to perform this action.
404Not Found - The resource could not be found.
405Method Not Allowed - You tried to access a resource with an invalid method.
410Gone - The resource requested has been removed from our servers.
413Payload Too Large - Your bulk request is too large. Please see the limitations.
422Unprocessable Entity - You have validation errors in some fields.
429Too Many Requests - You're performing too many requests! Slow down!
500Internal Server Error - We had a problem with our server. Try again later.
503Service Unavailable - We're temporarily offline for maintenance. Please try again later.
507Insufficient Storage - Storage is full. Please, remove something or upgrade your account.