# Get Contact

`lawmatics_get-contact` · Lawmatics MCP tool · Contacts

Fetch a single contact from Lawmatics by ID, including standard fields, custom fields, and a `relationships` envelope of {id,type} pointers to related records (creating user, client, company, custom contact type, matters, tags, emails, phone numbers, addresses, notes, files, folders).

## Input

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

## Output

- **id** `string` (required) — Lawmatics contact ID
- **firstName** `string | null` (required) — Contact's first/given name; null if unset
- **lastName** `string | null` (required) — Contact's last/family name; null if unset
- **email** `string | null` (required) — Primary email address; null if unset
- **emailAddress** `string | null` (required) — Alternate email field returned by the API; may duplicate or differ from `email`; null if unset
- **phone** `string | null` (required) — Primary phone number as stored; null if unset
- **phoneNumber** `string | null` (required) — Alternate phone field returned by the API; may duplicate or differ from `phone`; null if unset
- **birthdate** `string | null` (required) — Date of birth as an ISO 8601 date; null if unset
- **namePrefix** `string | null` (required) — Honorific before the name (e.g. Mr., Dr.); null if unset
- **middleName** `string | null` (required) — Contact's middle name; null if unset
- **nameSuffix** `string | null` (required) — Suffix after the name (e.g. Jr., III); null if unset
- **informalName** `string | null` (required) — Preferred informal/nickname for the contact; null if unset
- **employer** `string | null` (required) — Contact's employer or organization; null if unset
- **occupation** `string | null` (required) — Contact's occupation or job role; null if unset
- **citizenship** `string | null` (required) — Contact's citizenship; null if unset
- **bio** `string | null` (required) — Free-text biography or notes about the contact; null if unset
- **title** `string | null` (required) — Job title; null if unset
- **hobbies** `string | null` (required) — Free-text hobbies or interests; null if unset
- **socialSecurity** `string | null` (required) — Social Security number as stored; null if unset
- **age** `number | null` (required) — Contact's age in years; null if unset
- **driverLicense** `string | null` (required) — Driver's license number as stored; null if unset
- **gender** `string | null` (required) — Contact's gender as stored; null if unset
- **maritalStatus** `string | null` (required) — Contact's marital status as stored; null if unset
- **timezone** `string | null` (required) — Contact's timezone identifier; null if unset
- **trackingSourceId** `string | null` (required) — ID of the tracking source the contact came from; null if unset
- **dateOfLastContact** `string | null` (required) — Date of the most recent contact as an ISO 8601 date; null if never contacted
- **daysSinceLastContact** `number | null` (required) — Whole days elapsed since the last contact; null if never contacted
- **photoUrl** `string | null` (required) — URL of the contact's photo; null if unset
- **contactType** `string | null` (required) — Contact classification as stored (e.g. lead, client); null if unset
- **createdAt** `string | null` (required) — When the contact was created, as an ISO 8601 timestamp; null if unknown
- **updatedAt** `string | null` (required) — When the contact was last updated, as an ISO 8601 timestamp; null if unknown
- **customFields** `array` (required) — Account-defined custom fields on the contact; 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`
- **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 'prospect' -> get-matter, type 'user' -> get-user, type 'company' -> get-company).
  - **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
  - **client** `object | null` (required) — Linked client (matter) 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
  - **customContactType** `object | null` (required) — Custom contact-type 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) — Matter (prospect) 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
  - **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
  - **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
  - **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