# Find Matter By Email

`lawmatics_find-matter-by-email` · Lawmatics MCP tool · Lookups

Fuzzy-find a single matter (legal case) in Lawmatics by the client's email address; use get-matter for full details. Returns `{ match: <entity> }` on a hit and `{ match: null }` when no record matches. `match: null` is a normal empty result, not an error — do not retry.

## Input

- **emailAddress** `string(email)` (required, pattern: ^(?!\.)(?!.*\.\.)([A-Za-z0-9_'+\-\.]*)[A-Za-z0-9_+-]@([A-Za-z0-9][A-Za-z0-9\-]*\.)+[A-Za-z]{2,}$) — Email address to search for. Expects a valid email address.

## Output

- **match** `object | null` (required) — The single best matching matter, or null if nothing matched. Returns `{ match: <entity> }` on a hit and `{ match: null }` when no record matches. `match: null` is a normal empty result, not an error — do not retry.
  - **id** `string` (required) — Lawmatics matter ID; pass to get-matter for full case details
  - **firstName** `string | null` (required) — Client's first/given name; null if unset
  - **lastName** `string | null` (required) — Client's last/family name; null if unset
  - **email** `string | null` (required) — Client's primary email address; null if unset
  - **phone** `string | null` (required) — Client's primary phone number as stored; null if unset
  - **createdAt** `string | null` (required) — When the matter was created, as an ISO 8601 timestamp; null if unknown
  - **updatedAt** `string | null` (required) — When the matter was last updated, as an ISO 8601 timestamp; null if unknown