API Limits and Data Storage

The following limits and quotas apply to the Tricentis Analytics APIs. These guidelines are assigned per instance of Tricentis Analytics.

  • A courtesy quota of 50,000 requests per day is provided per client. A "request" is a single request to the API. The application you use requests some data and gets a response. A request is not a single query.

  • There is a maximum limit of 10 requests per second per client across all users.

  • There is a maximum limit of 2,000 data objects that can be returned to a request. The response to each request returns a certain number of rows, with a maximum of 2,000. If your first request defines a query that results in more than 2,000 rows, then only the first 2,000 rows will be returned. You would then need to make another request using the same query, specifying that you want the next 2,000 rows, starting at 2,001.

Daily requests are refreshed every 24 hours after the first request is made.
Tricentis reserves the right to change limits and quotas for the Tricentis Analytics API at any time during the Tech Preview.

What if I need more than 50,000 requests?

When using Tricentis Analytics, the quota is 50,000 requests per day. If you would like an extension, please reach out to your Customer Success Manager or to Tricentis Support. It may be possible to grant an extension request; however, extensions are granted at the discretion of Tricentis.

How can I make the most out of my quota limits?

To make the most out of your daily quota limit, it is important to follow best practices when filtering to retrieve data. Following are OData examples for retrieving data. For each example, the base URL should be the URL you received from the API endpoint.

  • Retrieve certain fields from Defects

    https://u1.analytics.api.tricentis.com/defects?apikey=1280&$select=id,lastmodifieddate,projectid,
projectname,ssor,name,priority,severity,status,type,rootcause

  • Retrieve certain fields from Execution Summaries

    https://u1.analytics.api.tricentis.com/executionsummaries?apikey=1280&$select=id,projectid,projectname,
ssor,testsuiteid,releasename,executionenddate,releasename,total_executed,total_unexecuted,other_run

  • Retrieve your latest Test Run results, which you can filter by Last Modified Date

    https://u1.analytics.api.tricentis.com/latesttestrunstatuses?$filter=executionenddate eq 2020-11-19

  • Select only Projects that have a start date between 6 June 2020 and 8 December 2020

    https://u1.analytics.api.tricentis.com/projects?apikey=1280&$filter=startdate
 gt 2020-06-08 and startdate lt 2020-12-08