Skip to main content
GET
cURL

Authorizations

X-Session-Token
string
header
required

Session token for authentication.

Query Parameters

include
enum<string>[]

A comma separated list of related resources to include.

Available options:
contributors,
creator,
form,
organisation,
versions,
scheme_shares,
workflow,
workflow_instance,
workflow_version,
payload_users,
payload_operations,
payload_work_orders,
payload_schemes,
payload_images,
payload_videos,
payload_properties
filter
string
default:""

Filters the response data based on the value provided.

Available filters:

  • id_in: Filter by ID(s)
  • contains(short_id,xxx): Search submissions by their short ID — the reference shown in the UI (the first 8 hex characters of the full ID), e.g. contains(short_id,3b6f0147). Case-insensitive; partial (substring) match.
  • contributor_in: Filter submissions by contributor ID(s)
  • creator_in: Filter submissions by creator ID(s)
  • form_in: Filter submissions by form ID(s)
  • schema_in: Filter submissions by schema ID(s)
  • related_resources.id_in: Filter submissions by related resource ID(s) (mirrored from the latest version)

For more information on using named filters, see the docs

limit
integer<int64>
default:100

Limit the number of resources returned by the API

Required range: x >= 1
offset
integer<int64>
default:0

Offset the resources returned by the API

Required range: x >= 0
sort
enum<string>[]

A comma separated list of fields to sort by.

Available options:
created_at,
-created_at

Response

Get a list of submissions for a form.

JSON API response object

data
A list of form submissions · object[]
required
meta
object
required
jsonapi
object
required
included
object[]

Related resources that can be included when a form submission is returned

A user