---
title: "Batch execution as a CTRF report"
method: GET
path: "/v2/batch-executions/{executionId}/ctrf"
tags: ["Batch Executions"]
---

# Batch execution as a CTRF report

`GET /v2/batch-executions/{executionId}/ctrf`

## Request

- Base URL: `https://app.aiva.works` (the document declares no server; this is the origin it was published from)
- URL: `https://app.aiva.works/v2/batch-executions/{executionId}/ctrf`
- Auth: API key in header `X-API-KEY`

The batch execution and its test runs, as one CTRF report.

## Path parameters

- `executionId` string, guid, required

## Response `200`

Batch execution as a CTRF report

- CtrfTestResults
  - `reportFormat` string, required
  - `specVersion` string, required
  - `results` Results, required
    - `tool` Tool, required
      - `name` string, required
    - `summary` Summary, required
      - `tests` integer, required
      - `passed` integer, required
      - `failed` integer, required
      - `pending` integer, required
      - `skipped` integer, required
      - `other` integer, required
      - `start` integer, nullable: Start time of the first test in milliseconds since the Unix epoch
      - `stop` integer, nullable: Stop time of the last test in milliseconds since the Unix epoch
      - `extra` SummaryExtra
        - `userEmail` string, nullable: Email of user which ran the test batch
        - `batchId` string, guid, nullable: v1: ID of the test batch execution. v2: ID of the defined batch this execution belongs to (null for an ad-hoc batch) -- see ExecutionId for the execution itself.
        - `executionId` string, guid, nullable: ID of the batch execution. Only populated in v2.
        - `testBatchLink` string, nullable: URL of the test batch in AIVA
    - `tests` Test[], required
      - `name` string, required: Test name
      - `status` string, required: Test run status as per the CTRF specification -- one of the following: passed, failed, skipped, pending, other (see https://ctrf.io/docs/specification/status)
      - `rawStatus` string: Test run status used in AIVA
      - `duration` integer, nullable: Duration of the test run in milliseconds
      - `start` integer, nullable: Start time of the test in milliseconds since the Unix epoch
      - `stop` integer, nullable: Stop time of the test in milliseconds since the Unix epoch
      - `message` string, nullable: Error message in case of a failed test
      - `parameters` object, nullable: Variables the test was run with
      - `extra` Extra, required
        - `testResultLink` string, nullable: URL of the test result in AIVA GUI
        - `testRunId` string, required: GUID of the test run this result corresponds to

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: User does not have permission to access batches
- `404`: Batch execution with given ID not found
- `500`: Server Error

---

[API](https://skmtc.dev/aiva/apis/aiva-cloud-api.md) · [All operations](https://skmtc.dev/aiva/apis/aiva-cloud-api/llms.txt) · [OpenAPI document](https://skmtc.dev/aiva/apis/aiva-cloud-api/revisions/70eef14d3bcd?raw)