# List Custom Form Entries

`lawmatics_list-custom-form-entries` · Lawmatics MCP tool · Custom Forms

List submitted entries for a Lawmatics custom intake form, with optional pagination and sorting. Each entry carries the submitted field answers as label/value pairs and an ID stub for the Prospect/Contact record the submission created.

## Input

- **customFormId** `string` (required, pattern: ^[0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{4}-[0-9a-fA-F]{12}$) — UUID of the custom form whose entries to list
- **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

- **entries** `array` (required) — Form entries on this page of results
  - **[]** `object`
    - **id** `string` (required) — Unique ID of the form entry (numeric string)
    - **body** `array` (required) — Submitted field answers as label/value pairs, in form order
      - **[]** `object`
        - **label** `string` (required) — Form field label this answer belongs to
        - **value** `any` (required) — Value the submitter entered for this field; type varies by field (string, number, boolean, ...). May contain personal information
    - **createdAt** `string` (required) — When the entry was submitted, as an ISO 8601 timestamp
    - **updatedAt** `string` (required) — When the entry was last updated, as an ISO 8601 timestamp
    - **customFormId** `string` (required) — ID of the custom form this entry was submitted to, as reported by the relationship stub. The saved Postman example shows the form's internal numeric ID here (e.g. "4"), not the UUID the other custom-form tools accept — do not feed this value back into lawmatics_get-custom-form
    - **contactable** `object | null` (required) — Reference to the Prospect/Contact record this submission created — an ID stub only; fetch the record separately for its details. Null when no record is linked
      - **id** `string` (required) — ID of the created record
      - **type** `string` (required) — Kind of record the submission created (e.g. "prospect", "contact")
- **pagination** `object` (required) — Pagination metadata derived from the API `meta` envelope
  - **totalPages** `number` (required) — Total number of pages available
  - **limitPerPage** `number` (required) — Maximum entries returned per page
  - **totalEntries** `number` (required) — Total number of entries across all pages