---
title: "Read a private verifier derivation run"
method: GET
path: "/experimental/orgs/{orgId}/verifier-derivation-runs/{runId}"
tags: ["Context"]
---

# Read a private verifier derivation run

`GET /experimental/orgs/{orgId}/verifier-derivation-runs/{runId}`

Returns the current status and validated verifier result for one org-owned private run without starting or retrying work. Pass the continuation returned by POST to pin this read to that generation. If another POST retries the run, the older continuation returns 409 instead of exposing the replacement generation.

## Path parameters

- `orgId` string, uuid, required
- `runId` string, uuid, required

## Query parameters

- `continuation` string

## Headers

- `Authorization` string

## Response `200`

Default Response

- union
  - object
    - `data` object, required
      - `runId` string, uuid, required
      - `continuation` string, required
      - `startedAt` string, date-time, nullable, required
      - `status` 'complete', required
      - `error` string, nullable, required
      - `completedAt` string, date-time, nullable, required
      - `digest` string, required
      - `verifiers` object[], required
        - `name` string, required
        - `instruction` string, required
        - `relevant_when` string, required
        - `context` string, required
        - `scope` union, required
          - 'file'
          - 'paths'
          - 'diff'
        - `scope_reason` string, required
        - `checklist` object[], required
          - `name` string, required
          - `rule` string, required
          - `relevant_when` string
        - `content` object
          - `containsAny` string[]
          - `containsAll` string[]
          - `regexAny` string[]
          - `regexAll` string[]
          - `notContainsAny` string[]
          - `notRegexAny` string[]
        - `references` object[]
          - `type` union
            - 'file'
            - 'user'
          - `filename` string
          - `file` string
          - `title` string
          - `line_no` integer
          - `note` string
        - `project_when` object
        - `covered_by` object[]
          - `type` union, required
            - 'lint'
            - 'test'
            - 'other'
          - `target` string, required
          - `hash` string, required
          - `verifier_fingerprint` string, required
          - `note` string
  - object
    - `data` object, required
      - `runId` string, uuid, required
      - `continuation` string, required
      - `startedAt` string, date-time, nullable, required
      - `status` 'failed', required
      - `error` string, nullable, required
      - `completedAt` string, date-time, nullable, required
      - `digest` unknown, required
      - `verifiers` unknown, required
  - object
    - `data` object, required
      - `runId` string, uuid, required
      - `continuation` string, required
      - `startedAt` string, date-time, nullable, required
      - `status` union, required
        - 'pending'
        - 'running'
      - `error` unknown, required
      - `completedAt` unknown, required
      - `digest` unknown, required
      - `verifiers` unknown, required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `409` — Conflict
- `500` — Internal Server Error

## Changes

- **2026-09-15** `d50a02b79ad3` — 2 info
  - added the optional property `error/code` to the response with the `403` status
  - added the optional property `error/url` to the response with the `403` status
- **2026-09-15** `050f3217cf2c` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/tessl/apis/tessl-api/changes/experimental/orgs/:orgId/verifier-derivation-runs/:runId/get.md)

---

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