List Many Submissions

GET/v1/forms/{form_id}/submissions

Retrieves multiple submissions for a specified form.

Pagination

This endpoint supports two pagination strategies:

Offset-based pagination

Use limit and offset to navigate through pages

Cursor-based pagination

Use cursor with the ID of the last submission from the previous page
You may set offset=1 to exclude the cursor submission from results
Provides consistent results even when new submissions are received

Note: When using search, offset is limited to 1. Use cursor-based pagination to navigate through search results.

Authorization

x-api-key<token>

In: header

x-team-id<token>

In: header

Path Parameters

form_idstring

Query Parameters

limit?integer

Maximum number of submissions to return.

Default100

Range1 <= value <= 500

offset?integer

Number of submissions to skip. Limited to 1 when using search.

Default0

Range0 <= value

cursor?string

Submission ID to use as the starting point for pagination (inclusive).

Use cursor-based pagination when:

Navigating through search results
Working with large datasets
You need consistent results across pages

To get the next page, use the id of the last submission from the current page.

Set offset=1 to exclude the cursor submission itself from results.

Length24 <= length <= 24

sort?string

Sort order by creation date (created_at).

DESC: Newest submissions first (default)
ASC: Oldest submissions first

Default"DESC"

Value in"ASC" | "DESC"

search?string

Search term to filter submissions.

Performs substring matching (case-insensitive) across submission data.

When provided, offset-based pagination is limited to 1. Use cursor-based pagination to navigate through search results.

Length1 <= length <= 100

Response Body

curl -X GET "https://forms.vexrun.com/v1/forms/string/submissions?limit=100&offset=0&cursor=stringstringstringstring&sort=ASC&search=string"

curl -X GET "https://forms.vexrun.com/v1/forms/string/submissions?limit=100&offset=0&cursor=stringstringstringstring&sort=ASC&search=string"

{
  "results": [
    {
      "id": "string",
      "country": "string",
      "ip": "string",
      "user_agent": "string",
      "referer": "string",
      "data": {
        "property1": null,
        "property2": null
      },
      "files": [
        {
          "id": "string",
          "field_name": "string",
          "size": 0,
          "mime_type": "string",
          "ext": "string"
        }
      ],
      "created_at": 0
    }
  ],
  "total": 0
}

{
  "errors": [
    {
      "path": "string",
      "expected": "string",
      "value": null
    }
  ],
  "message": "string"
}

{
  "message": "string"
}