Share this page

# Get runs by query

## Description

Returns a list of runs by query (filter).

## URL

Copy code

    /LoadTest/rest/domains/{domainName}/projects/{projectName}/Runs/?query={<QUERY_NAME>["<YOUR_QUERY_VALUE>"]}

## Runs Query Values

QUERY_NAME options:

-     ID

-     Duration

## Remarks

The runs data can be passed as XML containing the equivalent data.

## HTTP method

GET: Returns a list of runs by query.

## Request

Headers:

- Content-Type: application/xml

- Accept: application/xml

Cookies:

Version | Cookie
--- | ---
2020 or later | LWSSO_COOKIE_KEY={LwssoCookie};
Earlier than 2020 | LWSSO_COOKIE_KEY={LwssoCookie};QCSession={QCSessionCookie};

Request body:

None

Request examples:

Copy code
Example request for a run with ID=1:

    GET http://<LRE_Server>/LoadTest/rest/domains/{domainName}/projects/{projectName}/Runs/?query={LoadTestID[1]}
    Content-Type: application/xml
    Accept: application/xml
    Cookie: LWSSO_COOKIE_KEY={LwssoCookie};

Copy code
Example request for a run with Duration=2:

    GET http://<LRE_Server>/LoadTest/rest/domains/{domainName}/projects/{projectName}/Runs/?query={Duration[2]}
    Content-Type: application/xml
    Accept: application/xml
    Cookie: LWSSO_COOKIE_KEY={LwssoCookie};

Copy code
Example request to get all runs that started after a specific time:

    GET http://<LRE_Server>/LoadTest/rest/domains/{domainName}/projects/{projectName}/Runs/?query={StartTime[>'2025-08-18T00:00:00.00']}
    Content-Type: application/xml
    Accept: application/xml
    Cookie: LWSSO_COOKIE_KEY={LwssoCookie};

## Response

Headers:

Content-Type: application/xml

Cookies:

None

HTML return code:

One of the HTTP return codes.

HTML body:

GET: Returns the data on the entity in the response. See Run Status XML.

Response example:

Copy code

    <Runs xmlns="http://www.hp.com/PC/REST/API">
        <Run>
            <TestID>176</TestID>
            <TestInstanceID>8</TestInstanceID>
            <PostRunAction>Collate Results</PostRunAction>
            <TimeslotID>1091</TimeslotID>
            <VudsMode>false</VudsMode>
            <ID>12</ID>
            <Duration>2</Duration>
            <RunState>Before Creating Analysis Data</RunState>
            <RunSLAStatus>Not Completed</RunSLAStatus>
        </Run>
    </Runs>

See also:

- Get run status by ID
- Start a test run

Tips to improve your search results... OpenText™ Enterprise Performance Engineering API Reference OpenText™ Enterprise Performance Engineering All View Local Help Center View Online Help Center(Undefined variable: _rscC_Basic_Variables.VersionLabel)