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

# Read a private verifier generation

`GET /experimental/orgs/{orgId}/verifier-generations/{runId}`

## Request

- Base URL: `https://api.tessl.io`
- URL: `https://api.tessl.io/experimental/orgs/{orgId}/verifier-generations/{runId}`
- Auth: none declared

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-10-09** `ac0136c0cdb4`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/tessl/apis/tessl-api/changes/experimental/orgs/:orgId/verifier-generations/: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/7386f1e6295b?raw)
