# Get Task Status

`lawmatics_get-task-status` · Lawmatics MCP tool · Task Statuses

Fetch a single task status from Lawmatics by ID, including a `relationships` envelope of {id,type} pointers to the tasks assigned this status.

## Input

- **taskStatusId** `string` (required, pattern: ^\d+$) — ID of the task status to fetch; a numeric string

## Output

- **id** `string` (required) — Lawmatics task status ID
- **name** `string` (required) — Task status name (e.g. Waiting for Client, In Progress)
- **color** `string` (required) — Hex color code for the status, e.g. #A7783B
- **createdAt** `string` (required) — When the task status was created, as an ISO 8601 timestamp
- **updatedAt** `string` (required) — When the task status was last updated, as an ISO 8601 timestamp
- **relationships** `object` (required) — JSON:API relationship pointers to related records as {id,type} stubs. Not materialized — follow a pointer by calling that resource's own get tool (e.g. type 'task' -> get-task).
  - **tasks** `array` (required) — Task pointers (type 'task') assigned this status; empty if none
    - **[]** `object`
      - **id** `string` (required) — ID of the referenced Lawmatics record
      - **type** `string` (required) — JSON:API record class of the reference; resolve it by calling that resource's own tool