> ## Documentation Index > Fetch the complete documentation index at: https://docs.formbox.app/llms.txt > Use this file to discover all available pages before exploring further. # Retrieve a submission > Retrieve a specific submission for a given form for the authenticated organization. ## OpenAPI ````yaml get /submissions/{submissionId} openapi: 3.1.0 info: title: Formbox API description: Formbox is an all in one forms solution for your business. version: 0.0.1 contact: name: Formbox Support email: support@formbox.app url: https://docs.formbox.app/api-reference servers: - url: https://app.formbox.app/api/v1 description: Production API security: [] paths: /submissions/{submissionId}: get: tags: - Submissions summary: Retrieve a submission description: >- Retrieve a specific submission for a given form for the authenticated organization. operationId: getSubmission parameters: - in: path name: submissionId required: true description: The unique ID of the submission. example: clux0rgak00011... schema: $ref: '#/components/schemas/SubmissionIdParam' - in: query name: formId description: The unique ID of the form. schema: type: string description: The unique ID of the form. required: true - in: header name: api-key description: The API key. schema: $ref: '#/components/schemas/ApiKeyHeaderValue' required: true responses: '200': description: A specific submission. headers: Retry-After: description: Seconds until the current rate limit window resets. example: '60' schema: $ref: '#/components/schemas/RetryAfterHeader' required: true X-RateLimit-Limit: description: The number of requests allowed in the current rate limit window. example: '100' schema: $ref: '#/components/schemas/RateLimitLimitHeader' required: true X-RateLimit-Remaining: description: >- The number of requests remaining in the current rate limit window. example: '99' schema: $ref: '#/components/schemas/RateLimitRemainingHeader' required: true X-RateLimit-Reset: description: The Unix timestamp when the current rate limit window resets. example: '1711910400' schema: $ref: '#/components/schemas/RateLimitResetHeader' required: true content: application/json: schema: $ref: '#/components/schemas/SubmissionResponse' '401': $ref: '#/components/responses/401' '403': description: >- Your API key requires `read` or `full` access scope to retrieve a submission. content: application/json: schema: type: object properties: error: type: object properties: code: type: string enum: - forbidden description: A short code indicating the error code returned. example: forbidden message: type: string description: A human readable explanation of what went wrong. example: >- Your API key requires read or full access scope to retrieve a submission. required: - code - message required: - error '404': description: >- No submission with this ID was found. Verify the `submissionId` is correct and that it belongs to a form in the organization associated with your API key. content: application/json: schema: type: object properties: error: type: object properties: code: type: string enum: - not_found description: A short code indicating the error code returned. example: not_found message: type: string description: A human readable explanation of what went wrong. example: >- No submission with this ID was found. Check that the submissionId is correct and belongs to a form in your organization. required: - code - message required: - error '422': $ref: '#/components/responses/422' '429': $ref: '#/components/responses/429' '500': $ref: '#/components/responses/500' security: - token: [] components: schemas: SubmissionIdParam: type: string ApiKeyHeaderValue: type: string description: The API key. title: api-key RetryAfterHeader: type: string RateLimitLimitHeader: type: string RateLimitRemainingHeader: type: string RateLimitResetHeader: type: string SubmissionResponse: type: object properties: id: type: string description: The unique ID of the submission. formId: type: string description: The ID of the form. isSpam: type: boolean description: Whether the submission is spam. answers: type: array items: $ref: '#/components/schemas/SubmissionAnswer' description: The answers for the submission. files: type: array items: $ref: '#/components/schemas/SubmissionFile' description: The files for the submission. createdAt: type: string description: The date the submission was created. updatedAt: type: string description: The date the submission was last updated. required: - id - formId - isSpam - createdAt - updatedAt title: Submission SubmissionAnswer: type: object properties: id: type: string description: The answer ID. label: type: string description: The answer label. value: type: string description: The answer value. required: - id - label - value SubmissionFile: type: object properties: id: type: string description: The file ID. name: type: string description: The file name. type: type: string description: The file type. size: type: number description: The file size in bytes. url: type: string description: The file URL. createdAt: type: string description: The date the file was created. updatedAt: type: string description: The date the file was last updated. required: - id - name - type - size - url - createdAt - updatedAt responses: '401': description: >- No valid API key was provided. Include your API key in the `api-key` request header. You can generate API keys in your Formbox organization settings. content: application/json: schema: type: object properties: error: type: object properties: code: type: string enum: - unauthorized description: A short code indicating the error code returned. example: unauthorized message: type: string description: A human readable explanation of what went wrong. example: >- No API key provided. Pass your API key in the api-key header. required: - code - message required: - error '422': description: The request parameters or body failed validation. content: application/json: schema: type: object properties: error: type: object properties: code: type: string enum: - unprocessable_entity description: A short code indicating the error code returned. example: unprocessable_entity message: type: string description: A human readable explanation of what went wrong. example: The request was well-formed but contained semantic errors. required: - code - message required: - error '429': description: >- Too many requests. Check the X-RateLimit-* headers and retry after the reset time. headers: Retry-After: description: Seconds until the current rate limit window resets. example: '60' schema: $ref: '#/components/schemas/RetryAfterHeader' required: true X-RateLimit-Limit: description: The number of requests allowed in the current rate limit window. example: '100' schema: $ref: '#/components/schemas/RateLimitLimitHeader' required: true X-RateLimit-Remaining: description: The number of requests remaining in the current rate limit window. example: '99' schema: $ref: '#/components/schemas/RateLimitRemainingHeader' required: true X-RateLimit-Reset: description: The Unix timestamp when the current rate limit window resets. example: '1711910400' schema: $ref: '#/components/schemas/RateLimitResetHeader' required: true content: application/json: schema: type: object properties: error: type: object properties: code: type: string enum: - rate_limit_exceeded description: A short code indicating the error code returned. example: rate_limit_exceeded message: type: string description: A human readable explanation of what went wrong. example: Too many requests. Please slow down and try again shortly. required: - code - message required: - error '500': description: An unexpected error occurred on the server. content: application/json: schema: type: object properties: error: type: object properties: code: type: string enum: - internal_server_error description: A short code indicating the error code returned. example: internal_server_error message: type: string description: A human readable explanation of what went wrong. example: >- An internal server error occurred. Please contact support if the problem persists. required: - code - message required: - error ````