submissions

List submissions

Returns a form's submissions, newest first (unless you ask for the oldest).

Narrow the list with the filters below; several filters combine with AND.

To get the next page, pass a response's next_cursor as cursor and keep going until next_cursor is null. A page can occasionally hold fewer than limit results even when more exist, so rely on next_cursor, not on the page size.

get/v1/forms/{form_id}/submissions

Request

  • Base URL: https://api.formcarry.com
  • URL: https://api.formcarry.com/v1/forms/{form_id}/submissions
  • Auth: HTTP bearer

Path parameters

form_idstring required

The form's id, as shown in the dashboard and in the form's endpoint URL

Query parameters

status'inbox' | 'spam' | 'all'

Which submissions to include: the inbox (default), spam, or both.

read'true' | 'false'

Only submissions that have (true) or have not (false) been read in the dashboard.

has_attachments'true' | 'false'

Only submissions with (true) or without (false) uploaded files.

created_afterstring

Only submissions created at or after this time (RFC 3339, or milliseconds since the epoch).

created_beforestring

Only submissions created before this time (RFC 3339, or milliseconds since the epoch).

countrystring

Only submissions sent from this country. Two-letter uppercase code. For several, separate them with commas. Max 20.

qstring

Only submissions where any field contains this text, matched literally and without case. 2 to 512 characters. On some forms a field that only appeared in very old submissions may be missed, so name that field with a field filter.

order'newest' | 'oldest'

Newest first (the default) or oldest first.

limitnumber

Results per page.

cursorstring

The next_cursor value from the previous page.

fieldsstring

Only return these submitted fields, separated by commas. Everything else about the submission still comes back.

Response

has_moreboolean required

Whether another page exists. When true, request it with next_cursor.

next_cursorstring nullable required

Example response

{
  "data": [
    {
      "id": "64c000000000000000000001",
      "form_id": "AbC123xyz",
      "created_at": "2026-01-15T10:00:00.000Z",
      "country": "DE",
      "fields": [
        {
          "key": "email",
          "value": "ann@example.com"
        }
      ],
      "attachments": [
        {
          "key": "cv",
          "mime_type": "application/pdf"
        }
      ]
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.