---
title: "Get all test runs for the given filters."
method: GET
path: "/test-runs"
tags: ["TestRun"]
---

# Get all test runs for the given filters.

`GET /test-runs`

Get all test runs for the given filters.

## Query parameters

- `api-version` string, required
- `orderby` string
- `search` string
- `testId` string
- `executionFrom` string, date-time
- `executionTo` string, date-time
- `status` string
- `maxpagesize` integer
- `createdByTypes` string[]
- `testIds` string[]

## Response `200`

The request has succeeded.

- PagedTestRun — Paged collection of TestRun items
  - `value` TestRun[], required — The TestRun items on this page
    - `testRunId` string, required — Unique test run identifier for the load test run, must contain only lower-case alphabetic, numeric, underscore or hyphen characters.
    - `passFailCriteria` PassFailCriteria — Pass fail criteria for a test.
      - `passFailMetrics` object — Map of id and pass fail metrics { id : pass fail metrics }.
      - `passFailServerMetrics` object — Map of id and pass fail server metrics { id : pass fail metrics }.
    - `autoStopCriteria` AutoStopCriteria — Auto stop criteria for a test. This will automatically stop a load test if the error percentage is high for a certain time window.
      - `autoStopDisabled` boolean — Whether auto-stop should be disabled. The default value is false.
      - `errorRate` number, float — Threshold percentage of errors on which test run should be automatically stopped. Allowed values are in range of 0.0-100.0
      - `errorRateTimeWindowInSeconds` integer — Time window during which the error percentage should be evaluated in seconds.
      - `maximumVirtualUsersPerEngine` integer — Maximum number of virtual users per load testing engine, at which the test run should be automatically stopped.
    - `secrets` object — Secrets can be stored in an Azure Key Vault or any other secret store. If the secret is stored in an Azure Key Vault, the value should be the secret identifier and the type should be AKV_SECRET_URI. If the secret is stored elsewhere, the secret value should be provided directly and the type should be SECRET_VALUE.
    - `certificate` CertificateMetadata — Certificates metadata
      - `value` string — The value of the certificate for respective type
      - `type` 'AKV_CERT_URI' — Types of certificates supported.
      - `name` string — Name of the certificate.
    - `environmentVariables` object — Environment variables which are defined as a set of <name,value> pairs.
    - `errorDetails` ErrorDetails[] — Error details if there is any failure in load test run
      - `code` string — Error code if there is any failure in load test run.
      - `message` string — Error details in case test run was not successfully run.
      - `properties` object — A dictionary for storing additional error information for better context. Each key is a property name (e.g., "Description", "Resolution", "Category", "Region"), and its value is an array of strings with relevant details.
    - `testRunStatistics` object — Test run statistics. Key is the sampler name and value is the set of statistics for performance metrics like response time, throughput, etc. from the load test run. The sampler name is the same as the name mentioned in the test script. Sampler name "Total" represents the aggregated statistics of all the samplers.
    - `regionalStatistics` object — Regional statistics. Key is the Azure region name and value is the test run statistics. The region name should of format accepted by ARM, and should be a region supported by Azure Load Testing. For example, East US should be passed as "eastus". The region name must match one of the strings in the "Name" column returned from running the "az account list-locations -o table" Azure CLI command.
    - `loadTestConfiguration` LoadTestConfiguration — Configurations for the load test.
      - `engineInstances` integer — The number of engine instances to execute load test. Supported values are in range of 1-400. Required for creating a new test.
      - `splitAllCSVs` boolean — If false, Azure Load Testing copies and processes your input files unmodified across all test engine instances. If true, Azure Load Testing splits the CSV input data evenly across all engine instances. If you provide multiple CSV files, each file will be split evenly.
      - `quickStartTest` boolean — If true, optionalLoadTestConfig is required and JMX script for the load test is not required to upload.
      - `optionalLoadTestConfig` OptionalLoadTestConfiguration — Configuration for quick load test
        - `endpointUrl` string — Test URL. Provide the complete HTTP URL. For example, https://contoso-app.azurewebsites.net/login
        - `requestsPerSecond` integer — Target throughput (requests per second). This may not be necessarily achieved. The actual throughput will be lower if the application is not capable of handling it.
        - `maxResponseTimeInMs` integer — Maximum response time in milliseconds of the API/endpoint.
        - `virtualUsers` integer — No of concurrent virtual users.
        - `rampUpTime` integer — Ramp up time in seconds.
        - `duration` integer — Test run duration in seconds.
      - `regionalLoadTestConfig` RegionalConfiguration[] — Region distribution configuration for the load test.
        - `engineInstances` integer, required — The number of engine instances to execute load test in specified region. Supported values are in range of 1-400.
        - `region` string, required — Represents an Azure geography region where supported resource providers live.
    - `testArtifacts` TestRunArtifacts — Collection of test run artifacts
      - `inputArtifacts` TestRunInputArtifacts — The input artifacts for the test run.
        - `configFileInfo` TestRunFileInfo — Test run file info.
          - `fileName` string, required — Name of the file.
          - `url` string, uri — File URL.
          - `fileType` 'JMX_FILE' | 'USER_PROPERTIES' | 'ADDITIONAL_ARTIFACTS' | 'ZIPPED_ARTIFACTS' | 'URL_TEST_CONFIG' | 'TEST_SCRIPT' | 'BROWSER_RECORDING' | 'TEST_PLAN_RECOMMENDATIONS' — Types of file supported.
          - `expireDateTime` string, date-time — Expiry time of the file (RFC 3339 literal format)
          - `validationStatus` 'NOT_VALIDATED' | 'VALIDATION_SUCCESS' | 'VALIDATION_FAILURE' | 'VALIDATION_INITIATED' | 'VALIDATION_NOT_REQUIRED' — File status.
          - `validationFailureDetails` string — Validation failure error details
        - `testScriptFileInfo` TestRunFileInfo — Test run file info.
          - `fileName` string, required — Name of the file.
          - `url` string, uri — File URL.
          - `fileType` 'JMX_FILE' | 'USER_PROPERTIES' | 'ADDITIONAL_ARTIFACTS' | 'ZIPPED_ARTIFACTS' | 'URL_TEST_CONFIG' | 'TEST_SCRIPT' | 'BROWSER_RECORDING' | 'TEST_PLAN_RECOMMENDATIONS' — Types of file supported.
          - `expireDateTime` string, date-time — Expiry time of the file (RFC 3339 literal format)
          - `validationStatus` 'NOT_VALIDATED' | 'VALIDATION_SUCCESS' | 'VALIDATION_FAILURE' | 'VALIDATION_INITIATED' | 'VALIDATION_NOT_REQUIRED' — File status.
          - `validationFailureDetails` string — Validation failure error details
        - `userPropFileInfo` TestRunFileInfo — Test run file info.
          - `fileName` string, required — Name of the file.
          - `url` string, uri — File URL.
          - `fileType` 'JMX_FILE' | 'USER_PROPERTIES' | 'ADDITIONAL_ARTIFACTS' | 'ZIPPED_ARTIFACTS' | 'URL_TEST_CONFIG' | 'TEST_SCRIPT' | 'BROWSER_RECORDING' | 'TEST_PLAN_RECOMMENDATIONS' — Types of file supported.
          - `expireDateTime` string, date-time — Expiry time of the file (RFC 3339 literal format)
          - `validationStatus` 'NOT_VALIDATED' | 'VALIDATION_SUCCESS' | 'VALIDATION_FAILURE' | 'VALIDATION_INITIATED' | 'VALIDATION_NOT_REQUIRED' — File status.
          - `validationFailureDetails` string — Validation failure error details
        - `inputArtifactsZipFileInfo` TestRunFileInfo — Test run file info.
          - `fileName` string, required — Name of the file.
          - `url` string, uri — File URL.
          - `fileType` 'JMX_FILE' | 'USER_PROPERTIES' | 'ADDITIONAL_ARTIFACTS' | 'ZIPPED_ARTIFACTS' | 'URL_TEST_CONFIG' | 'TEST_SCRIPT' | 'BROWSER_RECORDING' | 'TEST_PLAN_RECOMMENDATIONS' — Types of file supported.
          - `expireDateTime` string, date-time — Expiry time of the file (RFC 3339 literal format)
          - `validationStatus` 'NOT_VALIDATED' | 'VALIDATION_SUCCESS' | 'VALIDATION_FAILURE' | 'VALIDATION_INITIATED' | 'VALIDATION_NOT_REQUIRED' — File status.
          - `validationFailureDetails` string — Validation failure error details
        - `urlTestConfigFileInfo` TestRunFileInfo — Test run file info.
          - `fileName` string, required — Name of the file.
          - `url` string, uri — File URL.
          - `fileType` 'JMX_FILE' | 'USER_PROPERTIES' | 'ADDITIONAL_ARTIFACTS' | 'ZIPPED_ARTIFACTS' | 'URL_TEST_CONFIG' | 'TEST_SCRIPT' | 'BROWSER_RECORDING' | 'TEST_PLAN_RECOMMENDATIONS' — Types of file supported.
          - `expireDateTime` string, date-time — Expiry time of the file (RFC 3339 literal format)
          - `validationStatus` 'NOT_VALIDATED' | 'VALIDATION_SUCCESS' | 'VALIDATION_FAILURE' | 'VALIDATION_INITIATED' | 'VALIDATION_NOT_REQUIRED' — File status.
          - `validationFailureDetails` string — Validation failure error details
        - `additionalFileInfo` TestRunFileInfo[] — Additional supported files for the test run
          - `fileName` string, required — Name of the file.
          - `url` string, uri — File URL.
          - `fileType` 'JMX_FILE' | 'USER_PROPERTIES' | 'ADDITIONAL_ARTIFACTS' | 'ZIPPED_ARTIFACTS' | 'URL_TEST_CONFIG' | 'TEST_SCRIPT' | 'BROWSER_RECORDING' | 'TEST_PLAN_RECOMMENDATIONS' — Types of file supported.
          - `expireDateTime` string, date-time — Expiry time of the file (RFC 3339 literal format)
          - `validationStatus` 'NOT_VALIDATED' | 'VALIDATION_SUCCESS' | 'VALIDATION_FAILURE' | 'VALIDATION_INITIATED' | 'VALIDATION_NOT_REQUIRED' — File status.
          - `validationFailureDetails` string — Validation failure error details
      - `outputArtifacts` TestRunOutputArtifacts — The output artifacts for the test run.
        - `resultFileInfo` TestRunFileInfo — Test run file info.
          - `fileName` string, required — Name of the file.
          - `url` string, uri — File URL.
          - `fileType` 'JMX_FILE' | 'USER_PROPERTIES' | 'ADDITIONAL_ARTIFACTS' | 'ZIPPED_ARTIFACTS' | 'URL_TEST_CONFIG' | 'TEST_SCRIPT' | 'BROWSER_RECORDING' | 'TEST_PLAN_RECOMMENDATIONS' — Types of file supported.
          - `expireDateTime` string, date-time — Expiry time of the file (RFC 3339 literal format)
          - `validationStatus` 'NOT_VALIDATED' | 'VALIDATION_SUCCESS' | 'VALIDATION_FAILURE' | 'VALIDATION_INITIATED' | 'VALIDATION_NOT_REQUIRED' — File status.
          - `validationFailureDetails` string — Validation failure error details
        - `logsFileInfo` TestRunFileInfo — Test run file info.
          - `fileName` string, required — Name of the file.
          - `url` string, uri — File URL.
          - `fileType` 'JMX_FILE' | 'USER_PROPERTIES' | 'ADDITIONAL_ARTIFACTS' | 'ZIPPED_ARTIFACTS' | 'URL_TEST_CONFIG' | 'TEST_SCRIPT' | 'BROWSER_RECORDING' | 'TEST_PLAN_RECOMMENDATIONS' — Types of file supported.
          - `expireDateTime` string, date-time — Expiry time of the file (RFC 3339 literal format)
          - `validationStatus` 'NOT_VALIDATED' | 'VALIDATION_SUCCESS' | 'VALIDATION_FAILURE' | 'VALIDATION_INITIATED' | 'VALIDATION_NOT_REQUIRED' — File status.
          - `validationFailureDetails` string — Validation failure error details
        - `artifactsContainerInfo` ArtifactsContainerInfo — Artifacts container info.
          - `url` string, uri — This is a SAS URI to an Azure Storage Container that contains the test run artifacts.
          - `expireDateTime` string, date-time — Expiry time of the container (RFC 3339 literal format)
        - `reportFileInfo` TestRunFileInfo — Test run file info.
          - `fileName` string, required — Name of the file.
          - `url` string, uri — File URL.
          - `fileType` 'JMX_FILE' | 'USER_PROPERTIES' | 'ADDITIONAL_ARTIFACTS' | 'ZIPPED_ARTIFACTS' | 'URL_TEST_CONFIG' | 'TEST_SCRIPT' | 'BROWSER_RECORDING' | 'TEST_PLAN_RECOMMENDATIONS' — Types of file supported.
          - `expireDateTime` string, date-time — Expiry time of the file (RFC 3339 literal format)
          - `validationStatus` 'NOT_VALIDATED' | 'VALIDATION_SUCCESS' | 'VALIDATION_FAILURE' | 'VALIDATION_INITIATED' | 'VALIDATION_NOT_REQUIRED' — File status.
          - `validationFailureDetails` string — Validation failure error details
    - `testResult` 'PASSED' | 'NOT_APPLICABLE' | 'FAILED' — Test result based on pass/fail criteria.
    - `virtualUsers` integer — Number of virtual users, for which test has been run.
    - `displayName` string — Display name of a testRun.
    - `testId` string — Associated test Id.
    - `description` string — The test run description.
    - `status` 'ACCEPTED' | 'NOTSTARTED' | 'PROVISIONING' | 'PROVISIONED' | 'CONFIGURING' | 'CONFIGURED' | 'EXECUTING' | 'EXECUTED' | 'DEPROVISIONING' | 'DEPROVISIONED' | 'DONE' | 'CANCELLING' | 'CANCELLED' | 'FAILED' | 'VALIDATION_SUCCESS' | 'VALIDATION_FAILURE' — Test run status.
    - `startDateTime` string, date-time — The test run start DateTime(RFC 3339 literal format).
    - `endDateTime` string, date-time — The test run end DateTime(RFC 3339 literal format).
    - `executedDateTime` string, date-time — Test run initiated time. This is legacy, new developments should use createdDateTime.
    - `portalUrl` string — Portal url.
    - `duration` integer — Test run duration in milliseconds.
    - `virtualUserHours` number, double — Virtual user hours consumed by the test run.
    - `subnetId` string — Subnet ID on which the load test instances should run.
    - `kind` 'URL' | 'JMX' | 'Locust' — Test kind
    - `requestDataLevel` 'NONE' | 'ERRORS' — Request data collection level for test run
    - `debugLogsEnabled` boolean — Enable or disable debug level logging. True if debug logs are enabled for the test run. False otherwise
    - `publicIPDisabled` boolean — Inject load test engines without deploying public IP for outbound access
    - `createdByType` 'User' | 'ScheduledTrigger' | 'AzurePipelines' | 'GitHubWorkflows' — The type of the entity that created the test run. (E.x. User, ScheduleTrigger, etc).
    - `createdByUri` string, uri — The URI pointing to the entity that created the test run.
    - `estimatedVirtualUserHours` number, double — Estimated virtual user hours for the test run.
    - `executionStartDateTime` string, date-time — The test run execution start DateTime(RFC 3339 literal format).
    - `executionEndDateTime` string, date-time — The test run execution end DateTime(RFC 3339 literal format).
    - `createdDateTime` string, date-time — The creation datetime(RFC 3339 literal format).
    - `createdBy` string — The user that created.
    - `lastModifiedDateTime` string, date-time — The last Modified datetime(RFC 3339 literal format).
    - `lastModifiedBy` string — The user that last modified.
  - `nextLink` string, uri — The link to the next page of items

## Other responses

- `default` — An unexpected error response.

## Changes

- **2026-07-13** (2022-11-01) `b15721d91722` — 1 info
  - added the new optional `query` request parameter `testIds`
- **2026-07-13** (2022-11-01) `c5851e131675` — 1 info
  - added the new optional `query` request parameter `createdByTypes`
- **2025-06-26** (2022-11-01) `e991fe514f8b` — 2 warning
  - deleted the `query` request parameter `createdByTypes`
  - deleted the `query` request parameter `testIds`

[Change history](https://skmtc.dev/azure/apis/loadtestservice-loadtesting/changes/test-runs/get.md)

---

[API](https://skmtc.dev/azure/apis/loadtestservice-loadtesting.md) · [All operations](https://skmtc.dev/azure/apis/loadtestservice-loadtesting/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/azure/loadtestservice-loadtesting/revisions/a39805b6167f/schema)