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

# Get a task

`GET /api/v1/tasks/{id}`

## Request

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

One task, by id.

## Path parameters

- `id` string, required

## Response `200`

The task.

- object
  - `data` Task, required: One piece of legal work, with its jurisdiction versions embedded.
    - `id` string
    - `area_id` string
    - `area_type` 'practice_area' | 'obligation'
    - `title` string
    - `slug` string
    - `url` string, uri, nullable: Null when the task has no page of its own and is listed on its area’s page.
    - `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.
    - `links` object[]
      - `title` string
      - `url` string, uri
      - `checked` string, nullable: Date the source was last read.
    - `jurisdiction_ids` string[]: Jurisdictions the task names.
    - `source_basis` string, nullable: How the task was sourced.
    - `versions` TaskVersion[]
      - `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.
    - `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)