> ## Documentation Index
> Fetch the complete documentation index at: https://developers.formstack.com/llms.txt
> Use this file to discover all available pages before exploring further.

# /submissions/{submissionId}

Retrieve detailed information about a specific submission

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "title": "Formstack API v2025.0",
    "version": "0.0.4"
  },
  "servers": [
    {
      "url": "https://www.formstack.com/api/v2025",
      "description": "Production server"
    },
    {
      "url": "https://staging-formstack.com/api/v2025",
      "description": "Staging server"
    },
    {
      "url": "https://dev-formstack.com/api/v2025",
      "description": "Development server"
    }
  ],
  "paths": {
    "/submissions/{submissionId}": {
      "get": {
        "tags": [
          "Submissions",
          "Classic"
        ],
        "description": "Retrieve detailed information about a specific submission",
        "operationId": "getSubmissionDetails",
        "parameters": [
          {
            "name": "submissionId",
            "in": "path",
            "description": "The unique identifier of the submission to retrieve",
            "required": true,
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "X-FS-Encryption-Password",
            "in": "header",
            "description": "Required when form has encryption enabled. The encryption password used to decrypt submission data",
            "required": false,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SubmissionDetailedApiDto"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized - Encryption password required or invalid"
          },
          "403": {
            "description": "Forbidden"
          },
          "404": {
            "description": "Not Found"
          },
          "500": {
            "description": "Internal Server Error"
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "SubmissionDataAddressValueApiDto": {
        "title": "Submission Data Address Value",
        "description": "Submission data address value response",
        "properties": {
          "address": {
            "description": "First part of the address",
            "type": "string",
            "nullable": true
          },
          "address2": {
            "description": "Second part of the address",
            "type": "string",
            "nullable": true
          },
          "city": {
            "description": "City of the address",
            "type": "string",
            "nullable": true
          },
          "country": {
            "description": "Country of the address",
            "type": "string",
            "nullable": true
          },
          "state": {
            "description": "State of the address",
            "type": "string",
            "nullable": true
          },
          "zip": {
            "description": "Zip of the address",
            "type": "string",
            "nullable": true
          }
        },
        "type": "object"
      },
      "SubmissionDataCheckboxValueApiDto": {
        "title": "Submission Data Checkbox Value",
        "description": "Submission data checkbox value response",
        "properties": {
          "values": {
            "description": "Values of the checkbox",
            "type": "array",
            "items": {
              "type": "string"
            },
            "nullable": true
          }
        },
        "type": "object"
      },
      "SubmissionDataCreditCardValueApiDto": {
        "title": "Submission Data CreditCard Value",
        "description": "Submission data credit card value response",
        "properties": {
          "card": {
            "description": "Number of the credit card",
            "type": "string",
            "nullable": true
          },
          "cardexp": {
            "description": "Expiration date of the credit card",
            "type": "string",
            "nullable": true
          }
        },
        "type": "object"
      },
      "SubmissionDataDatetimeValueApiDto": {
        "title": "Submission Data Datetime Value",
        "description": "Submission data datetime value response",
        "properties": {
          "values": {
            "description": "Values of the datetime",
            "type": "array",
            "items": {
              "type": "string"
            },
            "nullable": true
          }
        },
        "type": "object"
      },
      "SubmissionDataFileValueApiDto": {
        "title": "Submission Data File Value",
        "description": "Submission data file value response",
        "properties": {
          "values": {
            "description": "Values of the file",
            "type": "array",
            "items": {
              "type": "string"
            },
            "nullable": true
          }
        },
        "type": "object"
      },
      "SubmissionDataMatrixValueApiDto": {
        "title": "Submission Data Matrix Value",
        "description": "Submission data matrix value response",
        "properties": {
          "values": {
            "description": "Values of the matrix",
            "type": "array",
            "items": {
              "type": "string"
            },
            "nullable": false
          }
        },
        "type": "object"
      },
      "SubmissionDataNameValueApiDto": {
        "title": "Submission Data Name Value",
        "description": "Submission data name value response",
        "properties": {
          "prefix": {
            "description": "Prefix of the name",
            "type": "string",
            "nullable": true
          },
          "first": {
            "description": "First name of the name",
            "type": "string",
            "nullable": true
          },
          "initial": {
            "description": "Initial of the name",
            "type": "string",
            "nullable": true
          },
          "middle": {
            "description": "Middle of the name",
            "type": "string",
            "nullable": true
          },
          "last": {
            "description": "Last name of the name",
            "type": "string",
            "nullable": true
          },
          "suffix": {
            "description": "Suffix of the name",
            "type": "string",
            "nullable": true
          }
        },
        "type": "object"
      },
      "SubmissionDataProductValueApiDto": {
        "title": "Submission Data Product Value",
        "description": "Submission data product value response",
        "properties": {
          "chargeType": {
            "description": "ChargeType of the product",
            "type": "string",
            "nullable": true
          },
          "quantity": {
            "description": "Quantity of the product",
            "type": "string",
            "nullable": true
          },
          "total": {
            "description": "Total of the product",
            "type": "string",
            "nullable": true
          },
          "unitPrice": {
            "description": "UnitPrice of the product",
            "type": "string",
            "nullable": true
          }
        },
        "type": "object"
      },
      "SubmissionDataRadioValueApiDto": {
        "title": "Submission Data Radio Value",
        "description": "Submission data radio value response",
        "properties": {
          "values": {
            "description": "Values of the radio",
            "type": "array",
            "items": {
              "type": "string"
            },
            "nullable": true
          }
        },
        "type": "object"
      },
      "SubmissionDataSelectValueApiDto": {
        "title": "Submission Data Select Value",
        "description": "Submission data select value response",
        "properties": {
          "values": {
            "description": "Values of the select",
            "type": "array",
            "items": {
              "type": "string"
            },
            "nullable": true
          }
        },
        "type": "object"
      },
      "SubmissionDataSignatureValueApiDto": {
        "title": "Submission Data Signature Value",
        "description": "Submission data signature value response",
        "properties": {
          "values": {
            "description": "Values of the signature",
            "type": "array",
            "items": {
              "type": "string"
            },
            "nullable": true
          }
        },
        "type": "object"
      },
      "SubmissionDataApiDto": {
        "title": "Submission Data",
        "description": "Individual field data within a submission",
        "properties": {
          "field": {
            "description": "The unique identifier of the field this data belongs to",
            "type": "string",
            "nullable": false
          },
          "label": {
            "description": "The display label/name of the field",
            "type": "string",
            "nullable": true
          },
          "type": {
            "description": "The field type (text, email, select, etc.)",
            "type": "string",
            "nullable": true
          },
          "internalLabel": {
            "description": "The internal label/alias of the field for API usage",
            "type": "string",
            "nullable": true
          },
          "displayValue": {
            "description": "The formatted display value of the field as it would appear to users",
            "type": "string",
            "nullable": true
          },
          "parsedValue": {
            "description": "The structured, parsed value of the field data based on field type",
            "nullable": true,
            "oneOf": [
              {
                "$ref": "#/components/schemas/SubmissionDataNameValueApiDto"
              },
              {
                "$ref": "#/components/schemas/SubmissionDataAddressValueApiDto"
              },
              {
                "$ref": "#/components/schemas/SubmissionDataDatetimeValueApiDto"
              },
              {
                "$ref": "#/components/schemas/SubmissionDataProductValueApiDto"
              },
              {
                "$ref": "#/components/schemas/SubmissionDataCheckboxValueApiDto"
              },
              {
                "$ref": "#/components/schemas/SubmissionDataRadioValueApiDto"
              },
              {
                "$ref": "#/components/schemas/SubmissionDataFileValueApiDto"
              },
              {
                "$ref": "#/components/schemas/SubmissionDataMatrixValueApiDto"
              },
              {
                "$ref": "#/components/schemas/SubmissionDataSelectValueApiDto"
              },
              {
                "$ref": "#/components/schemas/SubmissionDataSignatureValueApiDto"
              },
              {
                "$ref": "#/components/schemas/SubmissionDataCreditCardValueApiDto"
              }
            ]
          }
        },
        "type": "object"
      },
      "SubmissionDetailedApiDto": {
        "title": "Submission Detailed",
        "description": "Comprehensive response containing all details of a submission",
        "properties": {
          "id": {
            "description": "The unique identifier of the submission",
            "type": "integer",
            "nullable": true
          },
          "timestamp": {
            "description": "The date and time when the submission was created",
            "type": "string",
            "nullable": true
          },
          "userAgent": {
            "description": "The browser user agent string of the submitter",
            "type": "string",
            "nullable": true
          },
          "remoteAddr": {
            "description": "The IP address from which the submission was made",
            "type": "string",
            "nullable": true
          },
          "paymentStatus": {
            "description": "The current payment status if the form includes payment processing",
            "type": "string",
            "nullable": true
          },
          "formId": {
            "description": "The unique identifier of the form this submission belongs to",
            "type": "integer",
            "nullable": true
          },
          "latitude": {
            "description": "The GPS latitude coordinate if location data was captured",
            "type": "string",
            "nullable": true
          },
          "longitude": {
            "description": "The GPS longitude coordinate if location data was captured",
            "type": "string",
            "nullable": true
          },
          "approvalStatus": {
            "description": "The current approval status (Approved, Denied, or Pending) if approvals are enabled",
            "type": "string",
            "nullable": true
          },
          "portal": {
            "description": "Portal information if the submission was made through a portal",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/SubmissionPortalApiDto"
            },
            "nullable": true
          },
          "data": {
            "description": "Array of field data contained in this submission",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/SubmissionDataApiDto"
            },
            "nullable": true
          },
          "prettyFieldId": {
            "description": "The field ID used to generate a human-readable name for this submission",
            "type": "integer",
            "nullable": true
          },
          "workflow": {
            "description": "Workflow information if the submission is part of a workflow process",
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/SubmissionWorkflowApiDto"
            },
            "nullable": true
          }
        },
        "type": "object"
      },
      "SubmissionPortalApiDto": {
        "title": "Submission Portal",
        "description": "Submission portal response",
        "properties": {
          "name": {
            "description": "Portal name of the submission",
            "type": "string",
            "nullable": true
          },
          "formName": {
            "description": "Portal form name of the submission",
            "type": "string",
            "nullable": true
          },
          "participantEmail": {
            "description": "Portal participant email of the submission",
            "type": "string",
            "nullable": true
          }
        },
        "type": "object"
      },
      "SubmissionWorkflowApiDto": {
        "title": "Submission Workflow",
        "description": "Submission workflow response",
        "properties": {
          "request_id": {
            "description": "The ID of the workflow request",
            "type": "integer",
            "nullable": true
          },
          "complete": {
            "description": "Is workflow completed",
            "type": "boolean",
            "nullable": true
          },
          "process_time": {
            "description": "Human-readable workflow process time. For completed workflows this is the time between submission start and completion; for in-progress workflows it is the time elapsed since submission start.",
            "type": "string",
            "nullable": true
          }
        },
        "type": "object"
      }
    }
  },
  "tags": [
    {
      "name": "Submissions",
      "description": "Submissions are the entries collected by your forms. Use these endpoints to create a submission, list submissions across all forms or for a specific form, count submissions, retrieve a single submission's data, edit or delete a submission, download uploaded files, and generate presigned URLs for direct file uploads. Results support pagination, date ranges, and field-level search."
    },
    {
      "name": "Classic",
      "description": "Classic"
    }
  ]
}
```