# Get Stage

`lawmatics_get-stage` · Lawmatics MCP tool · Pipeline Stages

Fetch a single pipeline stage from Lawmatics by ID, including a `relationships` envelope of {id,type} pointers to its parent pipeline and the prospects (matters) currently in the stage.

## Input

- **stageId** `string` (required, pattern: ^\d+$) — ID of the stage to fetch; a numeric string (e.g. '147')

## Output

- **id** `string` (required) — Lawmatics stage ID
- **name** `string` (required) — Stage name
- **color** `string | null` (required) — Stage display color as a hex string (e.g. '#bcc2c94d'); null if unset
- **order** `number | null` (required) — Position of the stage within its pipeline; null if unset
- **createdAt** `string` (required) — When the stage was created, as an ISO 8601 timestamp
- **updatedAt** `string` (required) — When the stage 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/find tool (e.g. type 'pipeline' -> get-pipeline, type 'prospect' -> get-matter).
  - **pipeline** `object | null` (required) — Parent pipeline pointer; null when unset
    - **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
  - **prospects** `array` (required) — Prospect (matter) pointers currently in this stage; 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