Skip to main content
GET
/
webhooks
/
{formId}
/
poll
List Form Responses
curl --request GET \
  --url https://api.formo.so/api/webhooks/{formId}/poll \
  --header 'x-api-key: <api-key>'
{
  "isSuccess": true,
  "data": {
    "items": [
      {
        "formId": "<string>",
        "formTitle": "<string>",
        "submissionId": "<string>",
        "submittedAt": "2023-11-07T05:31:56Z"
      }
    ]
  }
}
Retrieves form responses with transformed field data. Returns the most recent form submissions with field values mapped to readable keys based on the form configuration.
Locating Your Form ID.

​
Field Value Transformations

The API automatically transforms certain field values based on their type:
  • Select/Radio fields: Values are transformed to their display labels
  • Checkbox groups: Values are transformed into an array of {label, value} objects
  • Identity fields: Address objects are flattened to strings

​
Notes

  • The endpoint returns the 10 most recent form submissions
  • Field names in the response are derived from form field labels, converted to snake_case
  • All timestamps are returned in ISO 8601 format

Authorizations

​
x-api-key
string
header
required

Path Parameters

​
formId
string
required

The unique identifier of the form

Response

Successfully retrieved form responses

​
isSuccess
boolean
Example:

true

​
data
object