Dashform

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.

GET
/organizations/{organizationRef}/forms/{formRef}/revisions/{formRevisionRef}/replies

Authorization

headerx-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.

Path Parameters

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.

Query Parameters

filter?string

AIP-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.

Default""
orderBy?string

Comma-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.

Default""
pageSize?integer

Maximum 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.

Range0 <= value <= 9007199254740991
Default10
pageToken?string

Opaque continuation token from the previous list response.

Default""
skip?integer

Number 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.

Range0 <= value <= 2147483647
Default0

Response Body

OK

application/json
  1. response
nextPageToken*string

Continuation token for the next page. Empty on the final page.

totalSize*integer

Number of resources matching the filter before pagination. Estimates must be documented.

Range0 <= value <= 9007199254740991
replies*array<>

The Replies in this page.

Example Request
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'
Example Response
{  "nextPageToken": "string",  "totalSize": 0,  "replies": [    {      "answers": {},      "attribution": {        "campaign": "",        "content": "",        "medium": "",        "source": "",        "term": ""      },      "completeTime": null,      "createTime": "2026-10-21T08:24:05.069Z",      "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-21T08:24:05.071Z",      "voiceSession": null    }  ]}