TaskSubmission

The form submission for a task. Contains the operator's responses, timestamps, and review information. The fieldData array holds the actual form content as key-value pairs matching the form definition fields.

submissionIdstring

Submission identifier.

Example: 9102

statusstring

Submission review status: draft — started but not submitted. submitted — submitted by operator. pending_approval — awaiting reviewer. approved — reviewer approved. rejected — reviewer rejected. change_requested — reviewer requested modifications.

Possible values: [draft, submitted, pending_approval, approved, rejected, change_requested]

Example: approved

submittedAtstring<date-time>

When the operator submitted the form (ISO 8601).

Example: 2025-04-10T09:45:00Z

submittedByIdstring

ID of the operator who submitted.

Example: usr-00412

submittedByNamestring

Name of the operator who submitted.

Example: Maria Garcia

reviewedAtstring<date-time>

When the submission was reviewed (ISO 8601). Null if not yet reviewed.

Example: 2025-04-10T11:20:00Z

reviewedByIdstring

ID of the reviewer. Null if not yet reviewed.

Example: usr-00108

reviewedByNamestring

Name of the reviewer.

Example: James Chen

reviewCommentsstring

Comments left by the reviewer.

fieldData object[]

The form field values captured by the operator. Each entry corresponds to a field in the form definition. The value object structure varies by field type — for example, a temperature field stores value and unit, a checklist stores items with labels and checked states.

Array [

fieldIdstring

Form field identifier.

Example: 501

fieldLabelstring

Display label for this field.

Example: Surface Temperature

fieldTypestring

Type of form field (e.g., temperature, checklist, signature, text, number, photo).

Example: temperature

value object

The captured value. Structure depends on fieldType.

property name*any

The captured value. Structure depends on fieldType.

]

TaskSubmission

{
  "submissionId": "9102",
  "status": "approved",
  "submittedAt": "2025-04-10T09:45:00Z",
  "submittedById": "usr-00412",
  "submittedByName": "Maria Garcia",
  "reviewedAt": "2025-04-10T11:20:00Z",
  "reviewedById": "usr-00108",
  "reviewedByName": "James Chen",
  "reviewComments": "string",
  "fieldData": [
    {
      "fieldId": "501",
      "fieldLabel": "Surface Temperature",
      "fieldType": "temperature",
      "value": {}
    }
  ]
}