---
title: "Wait for a job ordered via orderNewTest or orderRetest to complete"
method: POST
path: "/api/awaitTest/{reportID}"
---

# Wait for a job ordered via orderNewTest or orderRetest to complete

`POST /api/awaitTest/{reportID}`

## Request

- Base URL: `https://kilotest.com`
- URL: `https://kilotest.com/api/awaitTest/{reportID}`
- Auth: none required

## Path parameters

- `reportID` string, required: Report identifier returned by orderNewTest or orderRetest (example: 260503T0432-x9z)

## Request body

- object

## Response `200`

Wait for a job ordered via orderNewTest or orderRetest to complete

- object
  - `tool collection` ToolsFacts, required
    - `name` string, required
    - `description` object, required: Explanation of what Kilotest does and how to use its tools.
      - `what Kilotest does` string, required
      - `how to retrieve findings` object, required
        - `level 1` string, required
        - `level 2` string, required
        - `level 3` string, required
        - `level 4` string, required
      - `how to generate more findings` object, required
        - `new testing` string, required
        - `retesting` string, required
        - `latency` string, required
        - `confirmation` string, required
    - `URL` string, required: URL of the Kilotest MCP server.
    - `web users can obtain similar functionalities at` string, required
  - `tool name` string, required
  - `this request` object, required
    - `description` string, required
    - `method` 'POST', required
    - `URL` string, required
    - `closest ancestor request` RequestReference[], required
      - `tool name` string, required
      - `description` string, required
      - `method` 'GET' | 'POST', required
      - `URL` string, required
  - `URLs of similar requests for web users` object, required
    - `this request` unknown, required
    - `closest ancestor request` unknown, required
  - `response metadata` ResponseMetadata, required
    - `identifier` string, required: Unique identifier of this response (timestamp and random suffix).
    - `date and time` string, required: UTC date and time when the response was generated, in ISO 8601 format.
  - `response content` object, required
    - `details about your wait` union, required
      - object
        - `error` string, required
      - object
        - `report identifier` string, required: Identifier of the report, to pass to listIssues once the report is ready (example: 260503T0432-x9z).
    - `disposition of your wait` object, nullable, required
      - `outcome` 'completed' | 'failed' | 'timedOut', required
      - `what happened` string, required
      - `how you can check for completion` string, required

---

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