---
title: "Job status and progress, and the summary (passed, failed, issuesBySeverity) once the job is terminal. With ?wait=, held until the job ends or the seconds pass."
method: GET
path: "/jobs/{id}"
---

# Job status and progress, and the summary (passed, failed, issuesBySeverity) once the job is terminal. With ?wait=, held until the job ends or the seconds pass.

`GET /jobs/{id}`

## Request

- Base URL: `https://app.difficat.com/api/v1`
- URL: `https://app.difficat.com/api/v1/jobs/{id}`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

## Path parameters

- `id` string, required

## Query parameters

- `wait` integer

## Response `200`

OK

- JobStatus
  - `jobId` string, required
  - `status` 'running' | 'completed' | 'failed' | 'cancelled', required
  - `progress` object, required
    - `discovered` integer
    - `compared` integer
    - `issues` integer
  - `error` string
  - `summary` Summary: Totals, per-check pass/fail counts and issue counts by severity over every page of the job, whatever slice a report call returns.
    - `totalPages` integer, required
    - `totalDiscovered` integer: Pages discovery found, before any maxPages ceiling.
    - `passed` integer, required
    - `failed` integer, required
    - `duration` number: Seconds.
    - `startedAt` string, date-time
    - `completedAt` string, date-time
    - `byType` object, required: Pass and fail counts for the existence, content and visual checks.
      - `existence` object, required
        - `passed` integer, required
        - `failed` integer, required
      - `content` object, required
        - `passed` integer, required
        - `failed` integer, required
      - `visual` object, required
        - `passed` integer, required
        - `failed` integer, required
    - `issuesBySeverity` object: Issue counts over every page by severity, every key present: the verdict at a glance. Present on every job started after it was introduced.
      - `critical` integer
      - `high` integer
      - `medium` integer
    - `checkMode` 'text-only' | 'existence-only': The checks the job ran when fewer than all; absent on a full job. The byType counts of a check that did not run stay 0.
  - `createdAt` integer: Epoch ms.
  - `updatedAt` integer: Epoch ms.

## Other responses

- `401`: Missing job token
- `404`: Unknown job or wrong token

---

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