---
title: "Get all load tests by the fully qualified resource Id e.g
subscriptions/{subId}/resourceGroups/{rg}/providers/Microsoft.LoadTestService/loadtests/{resName}."
method: GET
path: "/tests"
tags: ["Test"]
---

# Get all load tests by the fully qualified resource Id e.g
subscriptions/{subId}/resourceGroups/{rg}/providers/Microsoft.LoadTestService/loadtests/{resName}.

`GET /tests`

Get all load tests by the fully qualified resource Id e.g
subscriptions/{subId}/resourceGroups/{rg}/providers/Microsoft.LoadTestService/loadtests/{resName}.

## Query parameters

- `api-version` string, required
- `orderby` string
- `search` string
- `lastModifiedStartTime` string, date-time
- `lastModifiedEndTime` string, date-time
- `maxpagesize` integer

## Response `200`

The request has succeeded.

- PagedTest — Paged collection of Test items
  - `value` Test[], required — The Test items on this page
    - `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.
    - `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.
    - `baselineTestRunId` string — Id of the test run to be marked as baseline to view trends of client-side metrics from recent test runs
    - `inputArtifacts` TestInputArtifacts — The input artifacts for the test.
      - `configFileInfo` TestFileInfo — Test 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` TestFileInfo — Test 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` TestFileInfo — Test 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` TestFileInfo — Test 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` TestFileInfo — Test 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` TestFileInfo[] — 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
    - `testId` string, required — Unique test identifier for the load test, must contain only lower-case alphabetic, numeric, underscore or hyphen characters.
    - `description` string — The test description.
    - `displayName` string — Display name of a test.
    - `subnetId` string — Subnet ID on which the load test instances should run.
    - `kind` 'URL' | 'JMX' | 'Locust' — Test kind
    - `publicIPDisabled` boolean — Inject load test engines without deploying public IP for outbound access
    - `keyvaultReferenceIdentityType` string — Type of the managed identity referencing the Key vault.
    - `keyvaultReferenceIdentityId` string — Resource Id of the managed identity referencing the Key vault.
    - `metricsReferenceIdentityType` 'SystemAssigned' | 'UserAssigned' — Type of the managed identity referencing the metrics.
    - `metricsReferenceIdentityId` string — Resource Id of the managed identity referencing the metrics.
    - `engineBuiltInIdentityType` 'SystemAssigned' | 'UserAssigned' — Managed identity type.
    - `engineBuiltInIdentityIds` string[] — Resource Ids of the managed identity built in to load test engines. Required if engineBuiltInIdentityType is UserAssigned.
    - `estimatedVirtualUserHours` number, double — Estimated virtual user hours for the test.
    - `preferences` TestPreferences — Preferences for the test.
      - `enableAIErrorInsights` boolean — Enable or disable AI based insights on Test Run Errors.
    - `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.

---

[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)