Skip to content

List form answers (paginated)

Request

Returns one page of submitted answers for the specified form. Because a form can accumulate a large number of submissions, results are delivered in pages.

Pagination flow:

  1. Call with pageNumber: 1 to get the first page.
  2. The response contains totalCount (total number of submissions) and a searchAfter cursor array that points to the last record in the current page.
  3. Increment pageNumber by 1 for each subsequent request. The searchAfter cursor in the response can be used for cursor-based navigation in advanced scenarios. Repeat until you have fetched all pages (compare collected count against totalCount).

Each answer object contains:

  • answers — array of per-question replies. Each entry uses short-hand field names: q (question ID), t (text), n (number), d (date), b (boolean), c (choice selections with text t, value v, and order o), fn (name fields: first, last, middle, prefix, suffix), a (address fields: line 1, line 2, city, state, postal code, country), p (phone: country code, area, number, extension), f (uploaded files: file ID, type, size), ac (answer comment).
  • userInfo — optional respondent info (full name) if collected.
  • point — total score (tp) when the form uses a calculator / quiz scoring.
  • answerFiles — metadata for files attached to the submission.
  • fileToken — token used to download file attachments.
  • publicId — public-facing submission identifier.
  • createDate — ISO 8601 timestamp of when the answer was submitted.

Returns 404 Not Found if the form does not exist or belongs to a different account.

Security
BearerAuth or ApiKeyAuth
Path
idstringrequired

The unique identifier (_id) of the form whose answers to retrieve.

pageNumberinteger, >= 1required

Page number to retrieve. Starts at 1. Increment by 1 for each subsequent page.

curl -i -X GET \
  'https://developers.forms.app/_mock/apis/v1/form/{id}/answer/p/{pageNumber}' \
  -H 'Authorization: Bearer <YOUR_JWT_HERE>'

Responses

Answer page returned successfully.

Bodyapplication/json
successboolean

Always true for successful responses.

Value:true
dataobject(AnswerPage)

The response payload. Shape depends on the endpoint.

errorsArray of any, <= 0 items

Always an empty array on success.

Response
{ "success": true, "data": { "totalCount": 0, "result": [], "searchAfter": [] }, "errors": [] }