---
title: "Query Test Executions"
method: GET
path: "/orgs/{orgName}/tests/executions/"
tags: ["TestExecutions"]
---

# Query Test Executions

`GET /orgs/{orgName}/tests/executions/`

## Request

- Base URL: `https://api.signadot.com/api/v2`
- URL: `https://api.signadot.com/api/v2/orgs/{orgName}/tests/executions/`
- Auth: API key in header `signadot-api-key`

Query test executions based on different criteria

## Path parameters

- `orgName` string, required

## Query parameters

- `isAutoDiff` string
- `skipDeletedTests` string
- `source` string
- `targetSandbox` string
- `targetRouteGroup` string
- `targetRoutingKey` string
- `targetRevision` string
- `cluster` string
- `published` boolean
- `testName` string
- `triggerID` string
- `triggerWorkload` string
- `executionPhase` string
- `runID` string
- `repo` string
- `repoPath` string
- `repoBranch` string
- `repoCommitSHA` string
- `label` string[]
- `from` string
- `to` string
- `orderDir` 'asc' | 'desc'
- `pageSize` integer
- `cursor` string

## Response `200`

OK

- TestexecutionsQueryResult[]
  - `cursor` string
  - `execution` TestExecution
    - `createdAt` string
    - `id` string
    - `results` TestExecutionResults
      - `checks` TestexecutionsChecks
        - `baseline` TestexecutionsCheck[]
          - `errors` TestexecutionsCheckError[]
            - `attrs` object
            - `message` string
            - `sourcePosition` SyntaxPosition
              - …
          - `name` string
        - `sandbox` TestexecutionsCheck[]
          - `errors` TestexecutionsCheckError[]
            - `attrs` object
            - `message` string
            - `sourcePosition` SyntaxPosition
              - …
          - `name` string
      - `trafficDiff` TrafficDiff
        - `additions` integer
        - `baselineSession` string
        - `capturePoints` TrafficmodelsBy[]
          - `direction` 'Inbound' | 'Outbound'
          - `kind` 'Job' | 'Deployment' | 'Rollout'
          - `name` string
          - `namespace` string
        - `captures` integer
        - `green` TrafficDiffSummary
          - `additions` integer
          - `captures` integer
          - `maxRelevance` number
          - `removals` integer
          - `replacements` integer
        - `maxRelevance` number
        - `red` TrafficDiffSummary
          - `additions` integer
          - `captures` integer
          - `maxRelevance` number
          - `removals` integer
          - `replacements` integer
        - `removals` integer
        - `replacements` integer
        - `targetSession` string
        - `unpairedCaptures` TestexecutionsUnpairedCapture[]
          - `baselineCaptureID` string
          - `targetCaptureID` string
        - `yellow` TrafficDiffSummary
          - `additions` integer
          - `captures` integer
          - `maxRelevance` number
          - `removals` integer
          - `replacements` integer
    - `spec` TestExecutionSpec
      - `executionContext` TestExecutionContext
        - `autoDiff` TestExecutionAutoDiff
          - `enabled` boolean: Enabled = true, requires the definition of a valid routing context
        - `cluster` string
        - `publish` boolean: Publish represents whether the test execution will show up by default in the UI, i.e. to filter out ad-hoc and test the test usage.
        - `routing` JobRoutingContext
          - `routegroup` string
          - `sandbox` string
        - `runID` string
        - `timeout` string: Timeout represents an optional timeout for the test execution. If not supplied, it defaults to the DefaultTimeout of the associated test, if that is present. If that is not present, it defaults to "5m". It should be a string representing an unsigned integer not exceeding 32 bits followed by a units character, which can be one of the following. - 'm' for minutes - 'h' for hours - 'd' for days - 'w' for weeks
      - `external` ExternalSpec
        - `branch` string
        - `commitSHA` string
        - `path` string
        - `repo` string
        - `script` string
        - `testName` string
      - `hosted` HostedSpec
        - `testName` string
      - `labels` object: Labels
    - `status` TestExecutionStatus
      - `baselineJob` string
      - `finalState` TestExecutionState
        - `canceled` TestExecutionCanceledState
          - `canceledAt` string
          - `canceledBy` 'timeout' | 'apiRequest' | 'internal'
          - `message` string
        - `failed` TestExecutionFailedState
          - `message` string
      - `finishedAt` string
      - `phase` 'pending' | 'in_progress' | 'failed' | 'succeeded' | 'canceled'
      - `startedAt` string
      - `targetJob` string
      - `testDeletedAt` string
      - `triggeredBy` TestExecutionTriggeredBy
        - `sandbox` string
        - `trigger` TestTrigger
          - `executionTemplate` TestExecutionTemplate
            - `autoDiff` TestExecutionAutoDiff
              - …
            - `cluster` string
            - `publish` boolean: Publish represents whether the test execution will show up by default in the UI, i.e. to filter out ad-hoc and test the test usage.
            - `timeout` string: Timeout represents an optional timeout for the test execution. If not supplied, it defaults to the DefaultTimeout of the associated test, if that is present. If that is not present, it defaults to "5m". It should be a string representing an unsigned integer not exceeding 32 bits followed by a units character, which can be one of the following. - 'm' for minutes - 'h' for hours - 'd' for days - 'w' for weeks
          - `id` string
          - `sandboxOf` WorkloadWorkload
            - `kind` string, required: Kind of the baseline workload.
            - `name` string, required: Name of the entity within the Kubernetes cluster.
            - `namespace` string, required: Namespace within which the entity lives in the Kubernetes cluster.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `502`: Bad Gateway

## Changes

- **2025-04-01** `111fb5560622`: 5 warning, 12 info
  - deleted the `query` request parameter `clusterName`
  - deleted the `query` request parameter `groupBy`
  - deleted the `query` request parameter `targetRouteGroupName`
  - deleted the `query` request parameter `targetSandboxName`
  - …13 more
- **2025-01-27** `b72653416f23`: 3 info
  - added the new optional `query` request parameter `isAutoDiff`
  - added the new optional `query` request parameter `skipDeletedTests`
  - added the new optional `query` request parameter `targetRoutingKey`
- **2024-09-26** `f20f3be8ae04`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/signadot/apis/signadot-api/changes/orgs/:orgName/tests/executions/get.md)

---

[API](https://skmtc.dev/signadot/apis/signadot-api.md) - [All operations](https://skmtc.dev/signadot/apis/signadot-api/llms.txt) - [OpenAPI document](https://skmtc.dev/signadot/apis/signadot-api/revisions/5e80b0f9c718?raw)