Get form submitted contacts

Get the contacts that signed up through the given form, most recent first by default, together with the
values they submitted (email, phone, name, address fields, discount code, and custom properties).

Pagination: results are cursor-based. Read paging from the response and pass its cursor to after
to fetch the next page or to before to step back; limit caps a page at 250 items. Cursors are opaque —
do not construct them. The list ends when no forward cursor is returned.

Timestamps: submittedAt is when the contact signed up through this form. Contacts are ordered by
contact creation time (derived from the contact ID), which for an already existing subscriber who later
submitted this form is earlier than submittedAt. Do not assume the two are the same value.

Custom properties: customProperties carries the values of non-standard fields configured on the
form. Each entry has the field name as configured on the form, a type (string, number, bool,
date, or list), and a value whose shape follows that type. The set of properties varies per form and
can vary per contact when a field was optional or added after earlier signups.

Scopes:
forms.read

Rate Limiting:
This endpoint is rate limited to 400 requests per minute.

Path Params
string
required

Form ID (24 character hexadecimal)

Query Params
integer
Defaults to 250

Number of items to return (max 250)

string
enum
Defaults to createdAt

Sort field. Contacts are ordered by contact creation time embedded in the contact ID. Note: the response 'date' field reflects when the contact submitted this form (signup time) and may differ from the sort key for existing subscribers.

Allowed:
string
enum
Defaults to desc

Sort direction

Allowed:
string

Cursor for forward pagination

string

Cursor for backward pagination

Headers
string
required
Defaults to 2026-preview

API version that specifies the response format and behaviour

Responses

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json