Query test-case insights

post

https://{tenant}.katalon.io/v2/ra/web/insight/test-cases

Returns test-case totals for the current project, with a list of test cases filtered by status. Select a test run with executionId, a period with fromDate and toDate, or an iteration with iterationType and iterationName. Without a selector, the query covers the last 28 days. Totals count every matching test case; statusFilter and testCaseLimit apply only to the testCases list. Requires access to the project.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Body Params

Select an iteration with iterationType and iterationName, or a period with both fromDate and toDate. Known limitation: the API does not define a date format or timezone for fromDate and toDate. A date-only toDate means midnight at the start of that date, not the end of it. Prefer iteration selectors.

iterationType

string | null

enum

RELEASE or SPRINT.

Allowed:

iterationName

string | null

iterationName from List report iterations.

fromDate

string | null

Start of the period, as a timestamp string.

toDate

string | null

End of the period (inclusive), as a timestamp string.

testCaseLimit

integer | null

Maximum test cases in the testCases list. There is no limit when it is omitted or null, so send a value.

executionId

int64 | null

Test run ID: the id from List test runs, or the executionId from Run a scheduled occurrence now. Not the run order number (executionOrder).

statusFilter

string | null

enum

Defaults to NOT_PASSED

Status of the test cases to include in the testCases list.

Headers

x-account-id

uuid

Account UUID when explicit account context is needed.

x-organization-id

int64

Organization ID when explicit organization context is needed.

x-project-id

int64

required

Project ID accessible to the key's user.

Responses

default

The request could not be completed. Check authentication, project access, IDs and selectors. Error statuses and response bodies vary by failure.

Language

Credentials

Basic

base64

URL

Loading…

Response

Choose an example:

application/json

200Test-case totals and optional details.