---
title: "Get a task version"
method: GET
path: "/api/v1/task-versions/{id}"
tags: ["Practice"]
---

# Get a task version

`GET /api/v1/task-versions/{id}`

## Request

- Base URL: `https://ailawframework.com`
- URL: `https://ailawframework.com/api/v1/task-versions/{id}`
- Auth: HTTP bearer

One version, by id.

## Path parameters

- `id` string, required

## Response `200`

The version.

- object
  - `data` TaskVersion, required: One jurisdiction version of a task.
    - `id` string
    - `task_id` string
    - `area_id` string
    - `jurisdiction_id` string
    - `jurisdiction_name` string, nullable: Name.
    - `title` string
    - `url` string, uri, nullable
    - `ai_use` string, nullable: How AI is used.
    - `level` 'green' | 'yellow' | 'red' | 'manual': Involvement level. Green: AI drafts, lawyer checks. Yellow: lawyer and AI draft together. Red: lawyer writes; AI may only check, clarify or collect data. Manual: no AI.
    - `lawyer_review` string: What the lawyer must review.
    - `checking_plan` object: Who does what at each stage and what the lawyer checks.
      - `key` string, nullable: Plan key.
      - `label` string
      - `summary` string
      - `ai_role` string: What the AI does.
      - `lawyer_role` string: What the lawyer does.
      - `reviewer` string
      - `basis` string
      - `rationale` string
      - `restriction` string, nullable: A restriction on AI use, if any.
      - `checkpoints` string[]: Checks the lawyer makes.
      - `notes` string[]: Notes.
      - `sources` object[]
        - `title` string
        - `url` string, uri
        - `checked` string, nullable: Date the source was last read.
      - `practical_guide` object, nullable: A practical guide for the task.
        - `jurisdiction` string
        - `deliverable` string
        - `inputs` string[]: Inputs.
        - `example` string
        - `stop_when` string[]: Stop and escalate when.
        - `checked` string
      - `related_task_ids` string[]: Related task ids.
      - `written_for` string, nullable: Jurisdiction the plan was written for.
      - `source_basis` string: How the task was sourced.
    - `updated_at` string, nullable: ISO 8601.
  - `meta` object
    - `notice` string

## Other responses

- `304`: The If-None-Match you sent matches: nothing has changed.
- `401`: No key, or not a configured key.
- `404`: No published record with that id.
- `503`: The database could not be read. Retry. Nothing partial is ever returned.

---

[API](https://skmtc.dev/ailawframework/apis/ai-law-framework-data-api.md) · [All operations](https://skmtc.dev/ailawframework/apis/ai-law-framework-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ailawframework/apis/ai-law-framework-data-api/revisions/34dac450f68c?raw)