Form Submissions

Form submissions are individual submissions of a given form template.

https://api.validere.io/app

Search Form Submissions

Search form submissions

post

Query parameters

answersstringOptional

set to true to include answers

Example: true

Body

all ofOptional

and

and

Responses

200

successful operation

application/json

Responseall of

post

HTTPcURLJavaScriptPython

POST /app/v1/form_submissions/search HTTP/1.1
Host: api.validere.io
Content-Type: application/json
Accept: */*
Content-Length: 1115

{
  "page": 0,
  "page_size": 20,
  "sort_by": "created_at",
  "sort_direction": "asc",
  "filter": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "version": 1,
    "current_version": true,
    "status": "pending",
    "form_category_id": {
      "$in": [
        "748970de-fd1f-4494-ae3f-47cc21ff205f"
      ]
    },
    "form_category.name": "test",
    "form_schema.id": {
      "$in": [
        "748970de-fd1f-4494-ae3f-47cc21ff205f"
      ]
    },
    "form_schema.name": "text",
    "form_schema.version": 1,
    "form_schema.current_version": true,
    "form_schema.status": "active",
    "related_entity_id": "123e4567-e89b-12d3-a456-426614174000",
    "created_by": "123e4567-e89b-12d3-a456-426614174000",
    "created_at": "2025-08-19T00:19:43.068Z",
    "updated_at": "2025-08-19T00:19:43.068Z",
    "event.id": "123e4567-e89b-12d3-a456-426614174000",
    "measurement.measurement_type": "text",
    "measurement.measurement_unit": "text",
    "measurement.source_id": "123e4567-e89b-12d3-a456-426614174000",
    "measurement.subject_id": "123e4567-e89b-12d3-a456-426614174000",
    "measurement.form_submission_id": "123e4567-e89b-12d3-a456-426614174000",
    "measurement.section_id": "text",
    "measurement.question_id": "text",
    "measurement.question_index": 1,
    "measurement.time": "2025-08-19T00:19:43.068Z"
  }
}

200

successful operation

{
  "page_number": 0,
  "page_size": 10,
  "total_entries": 58,
  "total_pages": 6,
  "data": [
    {
      "company_id": "123e4567-e89b-12d3-a456-426614174000",
      "created_by": "123e4567-e89b-12d3-a456-426614174000",
      "form_schema_id": "123e4567-e89b-12d3-a456-426614174000",
      "form_schema_version": 1,
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "status": "pending"
    }
  ]
}

Search Form Submissions By Answers

Search form submissions by answers

post

Path parameters

form_schema_idstring · uuidRequired

Form Schema ID

Query parameters

versionintegerOptional

Form Schema Version

Body

all ofOptional

and

Responses

200

successful operation

application/json

Responseall of

post

HTTPcURLJavaScriptPython

POST /app/v1/form_submissions/search/form_schema/{form_schema_id} HTTP/1.1
Host: api.validere.io
Content-Type: application/json
Accept: */*
Content-Length: 342

{
  "page": 0,
  "page_size": 20,
  "sort_by": "created_at",
  "sort_direction": "asc",
  "filter": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "version": 1,
    "current_version": true,
    "status": "pending",
    "created_at": "2025-08-19T00:19:43.068Z",
    "updated_at": "2025-08-19T00:19:43.068Z",
    "created_by": "123e4567-e89b-12d3-a456-426614174000",
    "sectionId:questionId": "text"
  }
}

200

successful operation

{
  "page_number": 0,
  "page_size": 10,
  "total_entries": 58,
  "total_pages": 6,
  "data": [
    {
      "company_id": "123e4567-e89b-12d3-a456-426614174000",
      "created_by": "123e4567-e89b-12d3-a456-426614174000",
      "created_at": "2025-08-19T00:19:43.068Z",
      "updated_at": "2025-08-19T00:19:43.068Z",
      "form_schema_id": "123e4567-e89b-12d3-a456-426614174000",
      "form_schema_version": 1,
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "status": "pending",
      "submissionId:questionId": "text"
    }
  ]
}