Submissions

How to use the submission endpoints

Endpoints

Action	Method	URL
All submissions for a form	GET	/api/v1/forms/:identifier/submissions
Delete a submission	DELETE	/api/v1/forms/:identifier/submissions/:id

List submissions

curl -H 'Authorization: Bearer exampletoken' \
  'https://www.formbackend.com/api/v1/forms/:identifier/submissions?page=1&per_page=100'

{
  "submissions": [
    {
      "id": 980190963,
      "public_id": "01J...",
      "created_at": "2026-07-11T19:00:00Z",
      "values": {"name": "John Doe", "email": "john@example.org"},
      "url": "https://www.formbackend.com/forms/:identifier/submissions/980190963",
      "form_url": "https://www.formbackend.com/forms/:identifier",
      "trash": false,
      "spam": false,
      "email_status": "delivered"
    }
  ],
  "previous_page": null,
  "next_page": "https://www.formbackend.com/api/v1/forms/:identifier/submissions?page=2",
  "next_page_number": 2,
  "prev_page_number": null,
  "last_url": "https://www.formbackend.com/api/v1/forms/:identifier/submissions?page=2",
  "first_url": "https://www.formbackend.com/api/v1/forms/:identifier/submissions?page=1",
  "items": 100,
  "count": 150
}

Filtering

The list endpoint accepts these query parameters:

• filter=spam returns spam submissions.
• filter=trash returns discarded submissions.
• email_status filters by email-delivery status.
• from includes submissions created on or after an ISO-8601 timestamp.
• to includes submissions created on or before an ISO-8601 timestamp.
• page selects the result page.
• per_page controls page size and defaults to 100.

curl -H 'Authorization: Bearer exampletoken' \
  'https://www.formbackend.com/api/v1/forms/:identifier/submissions?filter=spam&from=2026-07-01T00:00:00Z'

Invalid from or to timestamps return a 400 Bad Request response.

Pagination

Use next_page and previous_page to follow result pages. first_url and last_url point to the first and last pages, count is the total matching record count, and items is the number of records on the current page.

Delete a submission

curl -H 'Authorization: Bearer exampletoken' \
  -X DELETE https://www.formbackend.com/api/v1/forms/:identifier/submissions/:id

Deleting through the API moves the submission to trash rather than immediately removing the database record.