List Submissions
Submissions
List Submissions
Requires forms-read. Supports pagination, search, and status filtering.
GET
List Submissions
List Submissions
Retrieve submissions for a specific form.Authentication & Scope
Requiresforms-read ability.
Request
Path Parameters
Query Parameters
Response
200 OK – Returns a paginated collection of Submission objects.
Response Fields
Each submission object contains:Data Object Structure
Thedata object contains:
- Form field responses: Keyed by field UUID, values vary by field type
- Metadata fields:
status: Submission status (completedorpartial)created_at: Submission creation timestampid: Submission ID (duplicate for convenience)
File Field Handling
File and signature fields are automatically processed to include download URLs:File URLs are signed and expire after 10 minutes for security.
Query Parameter Details
Search Functionality
- Searches within submission field values only (not field names/keys)
- Uses case-insensitive matching
- Supports partial text matching
Status Filtering
completed: Returns only fully completed submissionspartial: Returns only partially completed submissions (Pro feature)allor omitted: Returns all submissions regardless of status
Pagination
- Default
per_pageis 100, maximum is 100 - Results are ordered by
created_atin descending order (newest first)
403 Forbidden – The token lacks forms-read.Authorizations
Personal Access Token
Path Parameters
Query Parameters
Pagination page number
Required range:
x >= 1Number of results per page
Required range:
1 <= x <= 100Search term to filter submissions by field values
Filter by submission status
Available options:
completed, partial, all