---
title: "List Test Executions"
method: GET
path: "/v1/test-executions"
tags: ["Test Execution"]
---

# List Test Executions

`GET /v1/test-executions`

Returns a list of summarised test executions. The list is ordered by the start time of the execution, with the most recent execution first. It can be paginated by providing a `paginationToken` query parameter obtained from a previous response.

## Query parameters

- `projectId` string
- `paginationToken` string
- `limit` integer
- `testName` string
- `environmentName` string
- `startedAfter` string, date-time
- `startedBefore` string, date-time
- `timeFrame` string
- `status` 'RUNNING' | 'SUCCESS' | 'FAILED' | 'CANCELLING' | 'CANCELLED' | 'FORBIDDEN' | 'SKIPPED' | 'UNKNOWN'

## Response `200`

Test executions returned successfully

- ScrollResultListTestExecution
  - `more` string — Token for fetching the next batch of results for this query; if omitted then there are no more.
  - `results` TestExecution[] — Results of query
    - `environmentName` string — Name of the environment the test execution ran in
    - `finishedAt` string, date-time — The time the test execution finished
    - `message` string — Human-readable message describing the test execution outcome
    - `projectId` string — Identifier of the project the test execution belongs to
    - `scheduleId` string — Identifier of the schedule that triggered the test execution, if applicable
    - `startedAt` string, date-time — The time the test execution started
    - `status` string — Current status of the test execution
    - `testExecutionId` string — Unique identifier for the test execution
    - `testName` string — Name of the executed test
    - `trigger` 'DESIGNER' | 'API' | 'SCHEDULE' | 'SCHEDULE_RUN_NOW' | 'UNKNOWN' — What triggered the test execution
    - `user` string — The user who triggered the test execution, if applicable

## Other responses

- `400` — Wrong request parameters used
- `401` — Unauthorized
- `403` — Forbidden
- `500` — Unexpected error occurred
- `504` — Gateway timeout

---

[API](https://skmtc.net/maia/apis/maia-public-rest-api.md) · [All operations](https://skmtc.net/maia/apis/maia-public-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/maia/maia-public-rest-api/versions/6239825f68eb/schema)