# Get Matter

`lawmatics_get-matter` · Lawmatics MCP tool · Matters

Fetch a single matter (legal case) from Lawmatics by ID, including case details, status, contact information, matter value, custom fields, and a `relationships` envelope of {id,type} pointers to related records (contact, company, attorneys, tasks, notes, files, invoices, and more).

## Input

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

## Output

- **id** `string` (required) — Lawmatics matter ID
- **caseTitle** `string | null` (required) — Title of the matter/case; null if unset
- **caseBlurb** `string | null` (required) — Short description of the matter; null if unset
- **status** `string` (required) — Matter status (e.g. "pnc", "hired", "lost", "active")
- **subStatus** `string | null` (required) — Sub-status label within the status; null if unset
- **firstName** `string | null` (required) — First name of the matter's primary contact; null if unset
- **lastName** `string | null` (required) — Last name of the matter's primary contact; null if unset
- **middleName** `string | null` (required) — Middle name of the contact; null if unset
- **namePrefix** `string | null` (required) — Name prefix of the contact (e.g. Mr, Ms, Dr); null if unset
- **nameSuffix** `string | null` (required) — Name suffix of the contact (e.g. Jr, Sr, III); null if unset
- **informalName** `string | null` (required) — Informal name / nickname of the contact; null if unset
- **email** `string | null` (required) — Primary email address of the matter's contact; null if unset
- **phone** `string | null` (required) — Primary phone number of the matter's contact; null if unset
- **emailAddress** `string | null` (required) — Primary email address record value (mirrors email); null if unset or not reported
- **phoneNumber** `string | null` (required) — Primary phone number record value (mirrors phone); null if unset or not reported
- **address** `string | null` (required) — Combined display address of the contact; null if unset or not reported
- **birthdate** `string | null` (required) — Contact's date of birth; null if unset
- **age** `number | null` (required) — Contact's age in years, derived from birthdate; null if unknown or not reported
- **gender** `string | null` (required) — Contact's gender as stored; null if unset
- **maritalStatus** `string | null` (required) — Contact's marital status; null if unset
- **citizenship** `string | null` (required) — Contact's citizenship; null if unset
- **timezone** `string | null` (required) — Contact's time zone; null if unset
- **employer** `string | null` (required) — Contact's employer; null if unset
- **occupation** `string | null` (required) — Contact's occupation; null if unset
- **title** `string | null` (required) — Contact's job title; null if unset
- **bio** `string | null` (required) — Free-text biography of the contact; null if unset
- **hobbies** `string | null` (required) — Contact's hobbies as stored; null if unset
- **socialSecurity** `string | null` (required) — Contact's social security number; null if unset
- **driverLicense** `string | null` (required) — Contact's driver license number; null if unset
- **referringUrl** `string | null` (required) — URL the contact was referred from; null if unset
- **estimatedValueCents** `number | null` (required) — Estimated value of the matter in integer cents; null if unset
- **actualValueCents** `number | null` (required) — Actual value of the matter in integer cents; null if unset
- **leadCostCents** `number | null` (required) — Cost of acquiring this lead in integer cents; null if unset
- **dateOfLastContact** `string | null` (required) — When the contact was last contacted, as an ISO 8601 timestamp; null if never or not reported
- **daysSinceLastContact** `number | null` (required) — Days since the contact was last contacted; null if unknown or not reported
- **photoUrl** `string | null` (required) — Absolute URL of the contact's photo; null when none is set or not reported
- **customFields** `array` (required) — Account-defined custom fields on the matter; empty array if none
  - **[]** `object`
    - **id** `string` (required) — Custom field definition ID, as a numeric string
    - **name** `string | null` (required) — Custom field display name; null if unset
    - **fieldType** `string | null` (required) — Custom field data type (e.g. text, date, select); null if unset
    - **value** `any` (required) — Raw custom field value; type varies by `fieldType`
    - **formattedValue** `any` (required) — Display-formatted custom field value; type varies by `fieldType`
- **createdAt** `string` (required) — When the matter was created, as an ISO 8601 timestamp
- **updatedAt** `string` (required) — When the matter 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 'contact' -> get-contact, type 'user' -> get-user).
  - **source** `object | null` (required) — Lead source 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
  - **stage** `object | null` (required) — Pipeline stage 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
  - **campaign** `object | null` (required) — Marketing campaign 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
  - **practiceArea** `object | null` (required) — Practice area 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
  - **salesperson** `object | null` (required) — Salesperson (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
  - **leadAttorney** `object | null` (required) — Lead attorney (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
  - **originatingAttorney** `object | null` (required) — Originating attorney (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
  - **ownedBy** `object | null` (required) — Owning 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
  - **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
  - **contact** `object | null` (required) — Primary contact 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
  - **company** `object | null` (required) — Linked company 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
  - **assignedStaff** `array` (required) — Assigned staff (user) pointers; 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
  - **events** `array` (required) — Event pointers; 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
  - **fileRequests** `array` (required) — File-request pointers; 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
  - **documents** `array` (required) — Document pointers; 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
  - **files** `array` (required) — File pointers; 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
  - **folders** `array` (required) — Folder pointers; 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
  - **notes** `array` (required) — Note pointers; 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
  - **tasks** `array` (required) — Task pointers; 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
  - **emails** `array` (required) — Email-address pointers; 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
  - **phoneNumbers** `array` (required) — Phone-number pointers; 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
  - **addresses** `array` (required) — Address pointers; 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
  - **invoices** `array` (required) — Invoice pointers; 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
  - **tags** `array` (required) — Tag pointers; 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
  - **relationships** `array` (required) — Related-party relationship-record pointers; 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