# Get Sub Status

`lawmatics_get-sub-status` · Lawmatics MCP tool · Sub Statuses

Fetch a single matter sub status from Lawmatics by ID, including a `relationships` envelope of {id,type} pointers to the creating user and the matters (prospects) carrying this sub status.

## Input

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

## Output

- **id** `string` (required) — Lawmatics sub status ID
- **name** `string | null` (required) — Sub status name; null when the API omits or nulls this field in the response
- **status** `string | null` (required) — Matter status this sub status maps to; one of "hired", "pnc", or "lost". Null when the API omits or nulls this field in the response
- **createdAt** `string` (required) — When the sub status was created, as an ISO 8601 timestamp
- **updatedAt** `string` (required) — When the sub 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/find tool (type 'user' -> get-user, type 'prospect' -> get-matter).
  - **createdBy** `object | null` (required) — Creating user 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) — Pointers to matters (prospects) carrying this sub 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