Get Run by Query

Description

Returns a list of runs by query (filter).

URL

Copy code
/Admin/rest/v1/runs?query={<QUERY_NAME>["<YOUR_QUERY_VALUE>"]}

Runs Query Values

QUERY_NAME options:

  • ID

  • RunID

  • TestID

  • Domain;Project (filtering by Domain or Project requires both Domain and Project)

  • TestName

  • Name

  • StartDate

  • EndDate

  • Duration

  • UserName

  • ControllerName

  • RunState

  • PCVUsersMax

  • PCVUsersAvg

  • InvolvedVusers

  • TimeslotID

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:

Versions 2023 and later

ADM_LWSSO={ADM_LWSSO_COOKIE_VALUE};

Versions 2022 - 2022 R2

ADM_LWSSO={ADM_LWSSO_COOKIE_VALUE};

ASP.NET_SessionId_Adm={ASP.NET_SessionId_Adm_COOKIE_VALUE};

LWSSO_COOKIE_KEY={LWSSO_COOKIE_KEY_COOKIE_VALUE};

Versions 2021 - 2021 R2

ADM_LWSSO={ADM_LWSSO_COOKIE_VALUE};

ASP.NET_SessionId_Adm={ASP.NET_SessionId_Adm_COOKIE_VALUE};

Versions 2020 - 2020 SP3

ADM_LWSSO={ADM_LWSSO_COOKIE_VALUE};

Versions earlier than 2020

LWSSO_COOKIE_KEY={LWSSO_COOKIE_KEY_COOKIE_VALUE};

QCSession={QC_SESSION_COOKIE_VALUE};

Request Body:

None

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 response.

See Also

Get all runs
Get Run by Query