---
title: "Get a test execution"
method: GET
path: "/orgs/{orgName}/tests/executions/{executionID}"
tags: ["TestExecutions"]
---

# Get a test execution

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

## Request

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

Fetch the details about a given test execution.

## Path parameters

- `orgName` string, required
- `executionID` string, required

## Response `200`

OK

- TestExecution
  - `createdAt` string
  - `id` string
  - `results` TestExecutionResults
    - `checks` TestexecutionsChecks
      - `baseline` TestexecutionsCheck[]
        - `errors` TestexecutionsCheckError[]
          - `attrs` object
          - `message` string
          - `sourcePosition` SyntaxPosition
            - `col` integer: 1-based column (rune) number; 0 if column unknown
            - `line` integer: 1-based line number; 0 if line unknown
        - `name` string
      - `sandbox` TestexecutionsCheck[]
        - `errors` TestexecutionsCheckError[]
          - `attrs` object
          - `message` string
          - `sourcePosition` SyntaxPosition
            - `col` integer: 1-based column (rune) number; 0 if column unknown
            - `line` integer: 1-based line number; 0 if line unknown
        - `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
            - `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.
          - `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

---

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