Skip to main content
GET
Search FormPageRequests
A form request (FormPageRequest) sends a location’s form to a customer and tracks its submission. Creating a request sends an invitation unless it is already submitted; submitted answers are stored as separate records.

Authentication

This endpoint requires OAuth2 authentication. Include a valid bearer token in the Authorization header. The authenticated user must be a full unrestricted administrator or have the FormPageRequest-List role.

Query Parameters

Pagination & Sorting

integer
default:"1"
The page number to retrieve.
integer
default:"25"
The number of records per page.
string
The property name to sort results by (e.g. Name, CreatedOn).
integer
Sort direction. 0 for ascending, 1 for descending.

Filters

integer
Filter by iD of the customer invited to complete this form; cannot be changed after the request is created.
string
Filter by display value for Coworker.CoworkerType..
string
Filter by display value for Coworker.FullName..
string
Filter by display value for Coworker.CompanyName..
string
Filter by display value for Coworker.BillingName..
string
Filter by display value for Coworker.Email..
integer
Filter by iD of the form sent to the customer; the form’s location owns this request.
string
Filter by display value for FormPage.Name..
string
Filter by display value for FormPage.Business.Name..
string
Filter by uTC timestamp set automatically when the request is created and the invitation is sent.
boolean
Filter by whether the customer has submitted the form; set automatically by the public submission workflow.
string
Filter by system-managed unique ID linking this request to an event attendee; set by the event workflow and never supplied by an agent.
string
Filter by system-managed unique ID linking this request to an event; set by the event workflow and never supplied by an agent.
string
Filter by system-managed unique ID linking this request to a customer contract; set by the contract workflow and never supplied by an agent.

Range Filters

string
Filter by uTC timestamp set automatically when the request is created and the invitation is sent greater than or equal to this value. Format: YYYY-MM-DDTHH:mm.
string
Filter by uTC timestamp set automatically when the request is created and the invitation is sent less than or equal to this value. Format: YYYY-MM-DDTHH:mm.
string
Filter records created on or after this date. Format: YYYY-MM-DDTHH:mm.
string
Filter records created on or before this date. Format: YYYY-MM-DDTHH:mm.
string
Filter records updated on or after this date. Format: YYYY-MM-DDTHH:mm.
string
Filter records updated on or before this date. Format: YYYY-MM-DDTHH:mm.

Code Examples

Simple listing

Filtering by CreatedOn

Range filters

Response

200

FormPageRequest[]
The list of FormPageRequest records matching the query. See the Get one FormPageRequest endpoint for the full list of properties returned for each record.
integer
Current page number.
integer
Number of records per page.
string
The field used for sorting.
integer
The sort direction (0 = ascending, 1 = descending).
integer
Index of the first item on the current page.
integer
Index of the last item on the current page.
integer
Total number of matching records across all pages.
integer
Total number of pages.
boolean
Whether there is a next page of results.
boolean
Whether there is a previous page of results.
Example Response