---
title: "Get a form submission by ID."
method: GET
path: "/forms/submissions/{id}"
tags: ["forms"]
---

# Get a form submission by ID.

`GET /forms/submissions/{id}`

Retrieves a single form submission by its unique ID.

## Path parameters

- `id` string, required

## Headers

- `organization-id` string

## Response `200`

Form submission found.

- FormSubmissionResponseDto
  - `id` string — The unique identifier for the form submission.
  - `organizationId` string — The unique identifier for the client organization within Certify.
  - `mappedData` object — The mapped responses for the form submission. The structure of this object is flexible and can vary based on the form and its fields. Please request the specific structure from the Certify team if needed.
  - `submissionData` object — The raw responses for the form submission. The structure of this object is flexible and can vary based on the form and its fields. Please request the specific structure from the Certify team if needed.
  - `submissionPdf` object — The PDF document of the form submission, if available.
  - `submittedBy` FormSubmissionSubmittedByResponseDto
    - `email` string, required — The email of the user who submitted the form.
    - `user` object — The user information of the person who submitted the form.
  - `form` object — Information about the form associated with the submission.
  - `formVersionId` string — The id of the version of the form used for this submission.
  - `createdAt` string, required — The date and time when the form submission was created
  - `createdBy` string, required — The identifier of the user or system that created the submission.
  - `updatedAt` string, required — The date and time when the form submission was last updated

## Other responses

- `401` — Unauthorized if authorization token is not provided or invalid.
- `403` — Forbidden if user access is not right.
- `404` — Form submission not found.

---

[API](https://skmtc.net/certifyos/apis/certifyos-api.md) · [All operations](https://skmtc.net/certifyos/apis/certifyos-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/certifyos/certifyos-api/versions/df08dd00da43/schema)