Skip to content

Answer

Read submitted answers (responses) for a form. Because a form can accumulate thousands of submissions, answers are returned in pages. Each page contains a result array of answer objects, a totalCount of all submissions, and a searchAfter cursor you pass as the next pageNumber to continue walking through the full result set. Each answer captures the respondent's replies to every question, optional file attachments, user info, scoring points, and submission metadata such as creation date.

Operations

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": []
}