Skip to main content
GET
Get form definition and submissions

Authorizations

X-API-Key
string
header
required

API key for authentication

Headers

X-Organization-Id
string

Organization ID (required for session auth, optional for API key auth)

Path Parameters

formType
enum<string>
required

Slug of the evidence form. Call GET /v1/evidence-forms to see every form with its title.

Available options:
board-meeting,
it-leadership-meeting,
risk-committee-meeting,
meeting,
access-request,
whistleblower-report,
penetration-test,
rbac-matrix,
infrastructure-inventory,
employee-performance-evaluation,
network-diagram,
tabletop-exercise,
account-types

Query Parameters

Case-insensitive substring match over the submission answers

limit
string

Page size, 1-200. Defaults to 50.

offset
string

Submissions to skip. Defaults to 0.

Response

200 - application/json

Form definition and its submissions retrieved successfully. Note the envelope: { form, submissions, total }, not { data, count }.

form
object
required

Static definition of the form: its metadata and its fields

submissions
object[]
required

The page of submissions selected by search/limit/offset, newest first

total
number
required

Total submissions matching the search, before limit/offset

Example:

12