---
title: "Get Form Submission"
method: POST
path: "/form-submission/{id}/get-item"
tags: ["Form Submission"]
---

# Get Form Submission

`POST /form-submission/{id}/get-item`

## Request

- Base URL: `https://oneuptime.com/api`
- URL: `https://oneuptime.com/api/form-submission/{id}/get-item`
- Auth: API key in header `APIKey`
- TypeScript: <https://skmtc.dev/oneuptime/apis/oneuptime-openapi-specification/docs/form-submission/:id/get-item/post.ts> (a function with typed inputs; its response is checked against the schema)

Endpoint to retrieve a single Form Submission by ID

## Path parameters

- `id` string, uuid, required

## Request body

- object
  - `select` FormSubmissionSelectSchema: Select schema for FormSubmission. Set fields to true to include them in the response.
    - `_id` boolean
    - `createdAt` boolean
    - `updatedAt` boolean
    - `deletedAt` boolean
    - `projectId` boolean
    - `formId` boolean
    - `answers` boolean
    - `submitterName` boolean
    - `submitterEmail` boolean
    - `targetType` boolean
    - `incidentId` boolean
    - `scheduledMaintenanceId` boolean

## Response `200`

Successful response

- object
  - `data` FormSubmission
    - `_id` string, uuid: ID of this object. Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Read Form Submission], Update: [No access - you don't have permission for this operation]
    - `createdAt` object: Date and Time when the object was created. Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Read Form Submission], Update: [No access - you don't have permission for this operation]
    - `updatedAt` object: Date and Time when the object was updated. Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Read Form Submission], Update: [No access - you don't have permission for this operation]
    - `deletedAt` object: Date and Time when the object was deleted. Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Read Form Submission], Update: [No access - you don't have permission for this operation]
    - `version` number: Object version
    - `projectId` string, uuid, required: ID of your OneUptime Project in which this object belongs. Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Read Form Submission], Update: [No access - you don't have permission for this operation]
    - `formId` string, uuid, required: ID of the form this submission was made through. Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Read Form Submission], Update: [No access - you don't have permission for this operation]
    - `answers` object: Every question the submitter answered, in the form's order: the question's id (fieldId), its label when the form was submitted, the stored value, and the value as a person reads it (displayValue). Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Read Form Submission], Update: [No access - you don't have permission for this operation]
    - `submitterName` string: The name the submitter gave, as they typed it. Empty when the form does not ask for it, or lets people leave it out and they did. Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Read Form Submission], Update: [No access - you don't have permission for this operation]
    - `submitterEmail` object: The email address the submitter gave. It is not verified, and nothing is sent to it. Empty when the form does not ask for it, or lets people leave it out and they did. Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Read Form Submission], Update: [No access - you don't have permission for this operation]
    - `targetType` 'Incident' | 'ScheduledMaintenance': What the submission created: Incident, or ScheduledMaintenance (a scheduled maintenance event). Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Read Form Submission], Update: [No access - you don't have permission for this operation]
    - `incidentId` string, uuid: ID of the incident this submission created. Empty for a form that schedules maintenance, and once that incident is deleted. Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Read Form Submission], Update: [No access - you don't have permission for this operation]
    - `scheduledMaintenanceId` string, uuid: ID of the scheduled maintenance event this submission created. Empty for a form that creates incidents, and once that event is deleted. Permissions - Create: [No access - you don't have permission for this operation], Read: [Project Owner, Project Admin, Read Form Submission], Update: [No access - you don't have permission for this operation]

## Other responses

- `400`: Bad request. This response indicates that the request was malformed or contained invalid data.
- `401`: Unauthorized. This response indicates that the request requires user authentication.
- `402`: Payment Required. This response indicates that the request requires payment or a valid subscription.
- `403`: Forbidden. This response indicates that the server understood the request, but refuses to authorize it.
- `404`: Not found. The record does not exist, belongs to another project, or is one you may not read - the same answer for each.
- `405`: Project not found. This response indicates that the requested project does not exist or is not accessible.
- `408`: Request Timeout. This response indicates that the server timed out waiting for the request.
- `415`: Unable to reach server. This response indicates that the server is currently unreachable or down.
- `422`: Not authorized. This response indicates that the user does not have permission to access the requested resource.
- `500`: Internal Server Error. This response indicates that the server encountered an unexpected condition that prevented it from fulfilling the request.

---

[API](https://skmtc.dev/oneuptime/apis/oneuptime-openapi-specification.md) - [All operations](https://skmtc.dev/oneuptime/apis/oneuptime-openapi-specification/llms.txt) - [OpenAPI document](https://skmtc.dev/oneuptime/apis/oneuptime-openapi-specification/revisions/ba3307d00304?raw)