# Get Event

`lawmatics_get-event` · Lawmatics MCP tool · Events

Fetch a single event (appointment) from Lawmatics by ID, including its schedule, reminder settings, location, attendee details, cancellation state, and a `relationships` envelope of {id,type} pointers to related records (the matter/contact it is with, event type, address, location, and hosting firm users).

## Input

- **eventId** `string` (required, pattern: ^\d+$) — ID of the event (appointment) to retrieve; a numeric string

## Output

- **id** `string` (required) — Lawmatics event (appointment) ID
- **name** `string` (required) — Name/title of the event
- **description** `string | null` (required) — Description of the event; null if unset
- **timeZone** `string | null` (required) — IANA tz identifier the event is scheduled in (e.g. "America/Los_Angeles"); null if unset
- **startDate** `string | null` (required) — When the event starts, as an ISO 8601 timestamp; null when the date has been cleared
- **endDate** `string | null` (required) — When the event ends, as an ISO 8601 timestamp; null when the date has been cleared
- **allDay** `boolean | null` (required) — True when the event is an all-day event; null when never explicitly set (treat as not all-day)
- **reminderType** `string | null` (required) — Unit for the reminder delay ("minutes", "hours", "days", "weeks", "months"); null when no reminder is configured
- **reminderDelayLength** `number | null` (required) — How many reminderType units before the event the reminder is sent; null when no reminder is configured
- **reminderSent** `boolean` (required) — True when the reminder has already been sent
- **location** `object | null` (required) — Firm location the event is held at; null when no location is set
  - **id** `number` (required) — Lawmatics event location ID
  - **name** `string` (required) — Name of the event location
  - **addressId** `number | null` (required) — ID of the address record for the location; null for virtual locations (e.g. a Zoom URL venue)
- **sendInvites** `boolean | null` (required) — Whether calendar invites are sent to attendees; null if unset
- **eventTypeId** `number` (required) — ID of the event type this event belongs to
- **attendeeName** `string | null` (required) — Name of the attendee, derived from the attached record; null when unavailable
- **attendeeEmail** `string | null` (required) — Email of the attendee, derived from the attached record; null when unavailable
- **attendeePhone** `string | null` (required) — Phone of the attendee, derived from the attached record; null when unavailable
- **locationName** `string | null` (required) — Display name of the event location; null when no location is set
- **locationAddress** `string | null` (required) — Formatted street address of the event location; null when no location is set
- **zoomMeetingUrl** `string | null` (required) — Zoom meeting URL for the event; null when no Zoom meeting is linked
- **canceledAt** `string | null` (required) — When the appointment was canceled, as an ISO 8601 timestamp; null when not canceled. Canceled events remain retrievable.
- **createdAt** `string` (required) — When the event record was created, as an ISO 8601 timestamp
- **updatedAt** `string` (required) — When the event record 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 'prospect' -> get-matter, type 'contact' -> get-contact, type 'user' -> get-user).
  - **eventable** `object | null` (required) — The matter/contact the appointment is with (type "prospect" for a matter, "contact"); null when the event is unattached
    - **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
  - **eventType** `object | null` (required) — Event 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
  - **address** `object | null` (required) — Linked address-record pointer; null when none is linked
    - **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
  - **location** `object | null` (required) — Firm location pointer; null when no location is set
    - **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
  - **users** `array` (required) — Hosting/attending firm-user pointers; empty array 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