---
title: "Get a job"
method: GET
path: "/jobs/{id}"
tags: ["Jobs"]
---

# Get a job

`GET /jobs/{id}`

## Request

- Base URL: `https://api.suprememind.ai/v1`
- URL: `https://api.suprememind.ai/v1/jobs/{id}`
- Auth: HTTP bearer

Requires the `read` scope. Any job's status and, once it has succeeded, its
result: for an extraction the facts it wrote to the matter and which documents
it read; for a report analysis the structured `target_report`; for a brief a
pointer to `GET /briefs/{id}`. Results are read from the matter, so a matter
deleted since has none to show.

## Path parameters

- `id` string, required

## Response `200`

The job.

- Job
  - `id` string, required
  - `object` 'job', required
  - `kind` 'brief' | 'extract' | 'report', required
  - `livemode` boolean, required
  - `status` 'queued' | 'running' | 'succeeded' | 'failed', required
  - `matter_id` string, nullable
  - `created_at` string, date-time, required
  - `completed_at` string, date-time, nullable
  - `charged_credits` number, required
  - `result` object: Present once the job has succeeded. Its fields depend on the kind.
    - `fields` object, nullable: Extract. The facts the extraction wrote to the matter's case_context.
    - `documents` object[]: Extract. Which documents were read.
      - `id` integer
      - `filename` string
      - `status` 'read' | 'unreadable'
      - `reused` boolean
    - `extracted_at` string, date-time, nullable
    - `target_report` TargetReport
      - `mode` 'attack' | 'mirror'
      - `is_expert_report` boolean
      - `expert_name` string
      - `credentials` string
      - `retained_by` 'plaintiff' | 'defendant' | 'unknown'
      - `discipline` string
      - `report_caption` string
      - `damages_figure` string
      - `methodology_summary` string
      - `methods` object[]
        - `name` string
        - `role` string
      - `stated_opinions` string[]
      - `key_assumptions` string[]
      - `data_sources` string[]
      - `apparent_vulnerabilities` object[]
        - `target` string
        - `challenge_type` 'reliability' | 'fit' | 'qualifications' | 'helpfulness'
        - `basis` string
      - `analyzed_at` string, date-time
    - `document_id` integer, nullable
    - `mode` string, nullable
    - `brief_id` string: Brief. Fetch it at GET /briefs/{id}.
    - `url` string
  - `superseded` boolean: Report. A later analysis on the same matter has replaced this one's content.
  - `sample` object
    - `note` string
  - `error` object
    - `type` string
    - `code` string, nullable
    - `message` string, nullable

## Other responses

- `401`: Missing, malformed, unknown or revoked key.
- `403`: The key lacks the scope, the address is not on its allowlist, or API access is off for the account.
- `404`: Nothing with that id is visible to this key.
- `429`: Too many requests, or too many jobs in flight.

---

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