# List Custom Emails

`lawmatics_list-custom-emails` · Lawmatics MCP tool · Custom Emails

List custom emails from Lawmatics with optional pagination and sorting. Each custom email includes its name, subject, promotional flag, and engagement statistics — opens, sends, bounces, clicks, and open/click/bounce/delivered rates as fractions (null for never-sent emails).

## Input

- **page** `integer` (> 0) — Page number (1-based)
- **sortBy** `string` (enum: "id", "created_at", "updated_at") — Column to sort by
- **sortOrder** `string` (enum: "asc", "desc") — Sort direction; ascending or descending

## Output

- **customEmails** `array` (required) — Custom emails on this page of results
  - **[]** `object`
    - **id** `string` (required) — Lawmatics custom email ID
    - **name** `string` (required) — Internal name of the custom email
    - **subject** `string` (required) — Subject line of the custom email
    - **opens** `integer | null` (required) — Unique open count; null when the email has never been sent
    - **sends** `integer | null` (required) — Send count; null when the email has never been sent
    - **bounces** `integer | null` (required) — Bounce count; null when the email has never been sent
    - **clicks** `integer | null` (required) — Click count; null when the email has never been sent
    - **openRate** `number | null` (required) — Open rate as a raw fraction in 0..1 (e.g. 0.24 means 24%); null when the email has never been sent
    - **clickRate** `number | null` (required) — Click rate as a raw fraction in 0..1 (e.g. 0.02 means 2%); null when the email has never been sent
    - **bounceRate** `number | null` (required) — Bounce rate as a raw fraction in 0..1 (e.g. 0.15 means 15%); null when the email has never been sent
    - **deliveredRate** `number | null` (required) — Delivered rate as a raw fraction in 0..1 (e.g. 0.80 means 80%); null when the email has never been sent
    - **promotional** `boolean` (required) — Whether the email is marked as promotional
    - **createdAt** `string` (required) — When the custom email was created, as an ISO 8601 timestamp
    - **updatedAt** `string` (required) — When the custom email was last updated, as an ISO 8601 timestamp
- **pagination** `object` (required) — Pagination metadata derived from the API `meta` envelope
  - **totalPages** `number` (required) — Total number of pages available
  - **limitPerPage** `number` (required) — Maximum custom emails returned per page
  - **totalEntries** `number` (required) — Total number of custom emails across all pages