EaserixDocs
DevelopersAPI referenceFormsSubmissions

List submissions

Non-spam submissions by default; pass includeSpam=true for everything. created_at descending, limit 500. Submissions are children of the form, so a teammate who can read a shared form can read its inbox.

View as Markdown
GET
/v1/forms/{id}/submissions

Authorization

bearer
AuthorizationBearer <token>

In: header

Path Parameters

id*string

Query Parameters

includeSpam?"true"

Spam included only when exactly "true"

Value in

  • "true"

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/v1/forms/string/submissions"
{  "submissions": [    {      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",      "formId": "string",      "data": {        "property1": "string",        "property2": "string"      },      "isSpam": true,      "spamReason": "string",      "ip": "string",      "referrer": "string",      "userAgent": "string",      "created": "2019-08-24T14:15:22Z"    }  ]}

Delete a form

Owner-only; deletes the form and its submissions cascade. A form shared with the caller returns 403.

Delete submissions in bulk

Hard-deletes submissions and takes them off the form's counters. Exactly one selector, from the JSON body or the query string: ids (at most 1000; in the query, repeated or comma-separated) deletes those submissions whether or not they are spam, and ids of other forms are ignored; before (RFC 3339) deletes everything received before that instant, leaving spam alone unless includeSpam is true. Owner-only — a shared form returns 403. Recorded in the audit log (submissions.deleted) when anything was deleted.