# List Contacts

`lawmatics_list-contacts` · Lawmatics MCP tool · Contacts

List contacts from Lawmatics with optional pagination. Rows carry standard fields plus a `relationships` envelope of to-one {id,type} pointers (creating user, client, company, custom contact type); use get-contact for the full envelope including to-many relationships (matters, tags, emails, notes, files, ...).

## Input

- **page** `integer` (> 0) — Page number (1-based)

## Output

- **contacts** `array` (required) — Contacts on this page of results
  - **[]** `object`
    - **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
    - **phone** `string | null` (required) — Primary phone number as stored; 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
    - **relationships** `object` (required) — To-one JSON:API relationship pointers as {id,type} stubs. Not materialized — follow a pointer by calling that resource's own tool. List rows carry to-one pointers only; use get-contact for the full envelope incl. to-many (tags, emails, notes, files, ...).
      - **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
- **pagination** `object | null` (required) — Pagination metadata from the API response; null when the endpoint returns no meta envelope
  - **totalPages** `number | null` (required) — Total number of pages available; null if not reported
  - **limitPerPage** `number | null` (required) — Maximum contacts returned per page; null if not reported
  - **totalEntries** `number | null` (required) — Total number of contacts across all pages; null if not reported