# List Relationships

`lawmatics_list-relationships` · Lawmatics MCP tool · Relationships

List relationships from Lawmatics with optional pagination. Each relationship links a matter to a contact with a relationship type (e.g. Spouse, Child, Attorney).

## Input

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

## Output

- **relationships** `array` (required) — Relationships on this page of results
  - **[]** `object`
    - **id** `string` (required) — Unique ID of the relationship
    - **name** `string` (required) — Relationship name derived from the relationship type (e.g. Spouse, Child); read-only
    - **matterId** `string` (required) — ID of the matter on one side of the relationship
    - **contactId** `string` (required) — ID of the contact on the other side of the relationship
    - **hasPortalAccess** `boolean | null` (required) — Whether the related contact has client portal access; null if not reported
    - **createdAt** `string | null` (required) — When the relationship was created, as an ISO 8601 timestamp; null if unknown
    - **updatedAt** `string | null` (required) — When the relationship was last updated, as an ISO 8601 timestamp; null if unknown
- **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 relationships returned per page; null if not reported
  - **totalEntries** `number | null` (required) — Total number of relationships across all pages; null if not reported