# List Subtasks

`lawmatics_list-subtasks` · Lawmatics MCP tool · Subtasks

List the subtasks (checklist items) on a Lawmatics task, in checklist order, with optional pagination. Each row carries a `relationships` envelope with an {id,type} pointer to the parent task.

## Input

- **taskId** `string` (required, pattern: ^\d+$) — ID of the parent task whose subtasks to list; a numeric string
- **page** `integer` (> 0) — Page number (1-based)

## Output

- **subtasks** `array` (required) — Subtasks on this page of results, in checklist order
  - **[]** `object`
    - **id** `string` (required) — Unique ID of the subtask
    - **body** `string` (required) — Text content of the subtask
    - **order** `integer` (required) — Read-only zero-based position of the subtask within the parent task's checklist
    - **done** `boolean` (required) — Whether the subtask is completed
    - **createdAt** `string` (required) — When the subtask was created, as an ISO 8601 timestamp
    - **updatedAt** `string` (required) — When the subtask was last updated, as an ISO 8601 timestamp
    - **relationships** `object` (required) — JSON:API relationship pointers as {id,type} stubs. Not materialized — follow the pointer by calling that resource's own tool (type 'task' -> get-task).
      - **task** `object | null` (required) — Parent task pointer (type 'task'); null when unreported
        - **id** `string` (required) — ID of the referenced Lawmatics record
        - **type** `string` (required) — JSON:API record class of the reference (e.g. "user", "contact", "prospect", "firm"); resolve it by calling that resource's own get/find tool — this pointer is not materialized
- **pagination** `object | null` (required) — Pagination metadata from the API response; null when the endpoint returns no meta envelope
  - **totalPages** `number | null` (required) — Total number of pages available; null if not reported
  - **limitPerPage** `number | null` (required) — Maximum subtasks returned per page; null if not reported
  - **totalEntries** `number | null` (required) — Total number of subtasks across all pages; null if not reported