List the Replies to a Form Revision
Lists the Replies to a Form Revision, most recently created first. A Reply belongs to the Revision it answered, so address every Revision of the Form with the wildcard -. Page with pageSize and the nextPageToken the response carries, and narrow the page with filter and orderBy: filter completeTime:* for the Completed Replies only, and end a custom orderBy with path so pages never repeat or skip a Reply. Needs permission to read the Organization's Replies.
x-api-key<token>A Dashform API key, sent in the x-api-key header. Keys are created in the dashboard and act as the user who owns them.
organizationRef*||The Organization that owns the Form, addressed by its canonical id or by its slug. Responses always carry the canonical id.
formRef*||The Form, addressed by its canonical id or by its public id, the segment its public URL carries. Responses always carry the canonical id.
formRevisionRef*||The Revision the Replies answered: the wildcard - for every Revision, its canonical id, live, or latest. Responses always carry the canonical id.
filter?stringAIP-160 filter expression over the Reply fields completeTime, createTime, seenTime, path, leadScoring.scoreTime, leadScoring.state, and leadScoring.verdict. Combine conditions with AND, OR, and NOT. Example: completeTime:* AND leadScoring.verdict = "high". Omit or leave empty to apply no filter.
""orderBy?stringComma-separated fields with an optional asc or desc suffix: completeTime, createTime, seenTime, path, leadScoring.scoreTime, leadScoring.state, leadScoring.verdict. Defaults to createTime desc,path desc. Example: completeTime desc,path desc.
""pageSize?integerMaximum number of resources to return in one page. Omit or set to 0 to return up to 10 resources. Values above 1000 are capped at 1000. A page may contain fewer resources than requested; use nextPageToken to continue.
0 <= value <= 900719925474099110pageToken?stringOpaque continuation token from the previous list response.
""skip?integerNumber of resources to skip before returning a page, starting from the page token's position if supplied. Omit or set to 0 to skip none. Skipping past the end returns an empty page and no continuation token.
0 <= value <= 21474836470OK
application/json- response
nextPageToken*stringContinuation token for the next page. Empty on the final page.
totalSize*integerNumber of resources matching the filter before pagination. Estimates must be documented.
0 <= value <= 9007199254740991replies*array<>The Replies in this page.
curl -X GET 'https://getaiform.com/api/v1/organizations/497f6eca-6276-4993-bfeb-53cbbbba6f08/forms/497f6eca-6276-4993-bfeb-53cbbbba6f08/revisions/497f6eca-6276-4993-bfeb-53cbbbba6f08/replies'{ "nextPageToken": "string", "totalSize": 0, "replies": [ { "answers": {}, "attribution": { "campaign": "", "content": "", "medium": "", "source": "", "term": "" }, "completeTime": null, "createTime": "2026-10-27T14:53:19.545Z", "endStepKey": "", "followUps": [], "leadScoring": { "override": null, "result": null, "scoreTime": null, "state": "pending" }, "path": "string", "payment": null, "respondent": { "email": "", "name": "", "sentiment": "neutral" }, "seenTime": null, "source": "web", "stop": null, "updateTime": "2026-10-27T14:53:19.546Z", "voiceSession": null } ]}Get a published Form Revision GET
Reads the live Form Revision of a published Form without a credential: the Form as it was published, including the questions it asks. Address the Form by its public id under the wildcard Organization, as its public URL does. Only the live Revision is served; any other Revision is refused as a bad request, and a Form that was never published answers not found.
Submit a Reply POST
Submits a Completed Reply to the live Form Revision of a published Form without a credential, and answers with the stored Reply. Address the Form as the Form Revision read does. The answers are validated against the Form exactly as the Form's own page validates them. The Reply is recorded as filled by an agent, and its Ending is the one the Form's Branches resolve from the answers. Completing it fires the Form's integrations.