TAtally
Forms

List form submissions

Changed on

Returns a paginated list of form submissions with their responses.

get/forms/{formId}/submissions

Request

  • Base URL
    https://api.tally.so
  • URL
    https://api.tally.so/forms/{formId}/submissions
  • Auth
    HTTP bearer

Path parameters

formIdstring required

The ID of the form

Query parameters

pageinteger

Page number for pagination (default: 1)

filter'all' | 'completed' | 'partial'

Filter submissions by status

startDatestring date-time

Filter submissions submitted on or after this date (ISO 8601 format)

endDatestring date-time

Filter submissions submitted on or before this date (ISO 8601 format)

afterIdstring

Get submissions that came after a specific submission ID

limitinteger

Number of submissions to return per page (default: 50, max: 500)

Response

List of form submissions

pagenumber

Current page number

limitnumber

Number of submissions per page

hasMoreboolean

Whether there are more pages available

Changes

  • b4ea46b0b72dRevision changes
    • info

      added the optional property // to the response with the status

  • 94800fcb99adRevision changes
    • breaking

      for the query request parameter limit, the type changed from number to integer

    • breaking

      for the query request parameter page, the type changed from number to integer

    • warning

      for the query request parameter page, the min was set to 1.00