---
title: "Lists the runs of the specified job id."
method: GET
path: "/ingestion/jobs/{job-id}/runs"
tags: ["Ingestion:"]
---

# Lists the runs of the specified job id.

`GET /ingestion/jobs/{job-id}/runs`

## Path parameters

- `job-id` string, required

## Query parameters

- `api-version` string, required

## Headers

- `mgmt-user-token` string

## Response `200`

Success

- IngestionJobRunList — Represents a list of ingestion job runs.
  - `nextLink` string — The link to the next page.
  - `value` IngestionJobRun[] — The list of items.
    - `jobId` string
    - `runId` string
    - `status` 'notRunning' | 'running' | 'succeeded' | 'failed' — The state of a job or item.
    - `error` IngestionError — The details of the ingestion error
      - `message` string
      - `innerErrors` string[]
    - `warnings` string[]
    - `progress` IngestionJobProgress
      - `stageProgress` IngestionJobStageProgress[], required
        - `name` string
        - `totalItems` integer
        - `processedItems` integer
        - `state` 'notRunning' | 'running' | 'succeeded' | 'failed' — The state of a job or item.
        - `subStageProgress` IngestionJobStageProgress[]

## Other responses

- `default` — An error occurred.

---

[API](https://skmtc.net/azure/apis/cognitiveservices-azureopenai-authoring.md) · [All operations](https://skmtc.net/azure/apis/cognitiveservices-azureopenai-authoring/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/azure/cognitiveservices-azureopenai-authoring/revisions/b177dc430e39/schema)