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

# Get submission by id

> Returns a single submission by its ID



## OpenAPI

````yaml GET /forms/{formId}/submissions/{submissionId}
openapi: 3.0.1
info:
  title: Fillout REST API
  description: A REST API for managing forms, submissions, and webhooks in Fillout
  version: 1.0.0
servers:
  - url: https://api.fillout.com/v1/api
    description: US server
  - url: https://eu-api.fillout.com/v1/api
    description: EU server
security:
  - bearerAuth: []
paths:
  /forms/{formId}/submissions/{submissionId}:
    get:
      summary: Get submission by ID
      description: Returns a single submission by its ID
      operationId: getSubmissionById
      parameters:
        - name: formId
          in: path
          required: true
          schema:
            type: string
          description: The public identifier of the form
        - name: submissionId
          in: path
          required: true
          schema:
            type: string
          description: The identifier of the submission
        - name: includeEditLink
          in: query
          schema:
            type: boolean
          description: Pass true to include a link to edit the submission as 'editLink'
      responses:
        '200':
          description: Single submission
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SingleSubmissionResponse'
components:
  schemas:
    SingleSubmissionResponse:
      type: object
      properties:
        submission:
          $ref: '#/components/schemas/Submission'
          description: The submission data
      required:
        - submission
    Submission:
      type: object
      properties:
        submissionId:
          type: string
          description: Unique identifier for the submission
        submissionTime:
          type: string
          format: date-time
          description: When the submission was made
        lastUpdatedAt:
          type: string
          format: date-time
          description: When the submission was last updated
        questions:
          type: array
          items:
            $ref: '#/components/schemas/QuestionResponse'
          description: List of question responses
        calculations:
          type: array
          items:
            $ref: '#/components/schemas/CalculationResponse'
          description: List of calculation responses
        urlParameters:
          type: array
          items:
            $ref: '#/components/schemas/UrlParameterResponse'
          description: List of URL parameter values
        scheduling:
          type: array
          items:
            $ref: '#/components/schemas/SchedulingResponse'
          description: List of scheduling responses (if using Fillout Scheduling)
        payments:
          type: array
          items:
            $ref: '#/components/schemas/PaymentResponse'
          description: List of payment responses (if using Fillout Payments)
        quiz:
          $ref: '#/components/schemas/QuizResponse'
          description: Quiz results (if form is configured as quiz)
        login:
          $ref: '#/components/schemas/LoginResponse'
          description: Login information (if using login page)
      required:
        - submissionId
        - submissionTime
        - questions
    QuestionResponse:
      type: object
      properties:
        id:
          type: string
          description: Identifier of the question
        name:
          type: string
          description: The question text
        type:
          type: string
          description: The type of the question
        value:
          description: The response value
      required:
        - id
        - name
        - type
        - value
    CalculationResponse:
      type: object
      properties:
        id:
          type: string
          description: Identifier of the calculation
        name:
          type: string
          description: Name of the calculation
        type:
          type: string
          enum:
            - number
            - text
            - duration
          description: Type of the calculation
        value:
          type: string
          description: The calculated value
      required:
        - id
        - name
        - type
        - value
    UrlParameterResponse:
      type: object
      properties:
        id:
          type: string
          description: Identifier of the URL parameter
        name:
          type: string
          description: Name of the URL parameter
        value:
          type: string
          description: Value of the URL parameter
      required:
        - id
        - name
        - value
    SchedulingResponse:
      type: object
      properties:
        id:
          type: string
          description: Identifier of the scheduling field
        name:
          type: string
          description: Name of the scheduling field
        value:
          $ref: '#/components/schemas/SchedulingValue'
          description: Scheduling details
      required:
        - id
        - name
        - value
    PaymentResponse:
      type: object
      properties:
        id:
          type: string
          description: Identifier of the payment field
        name:
          type: string
          description: Name of the payment field
        value:
          $ref: '#/components/schemas/PaymentValue'
          description: Payment details
      required:
        - id
        - name
        - value
    QuizResponse:
      type: object
      properties:
        score:
          type: integer
          description: Quiz score
        maxScore:
          type: integer
          description: Maximum possible score
      required:
        - score
        - maxScore
    LoginResponse:
      type: object
      properties:
        email:
          type: string
          format: email
          description: Verified email address
      required:
        - email
    SchedulingValue:
      type: object
      properties:
        fullName:
          type: string
          description: Full name of the person booking
        email:
          type: string
          format: email
          description: Email of the person booking
        timezone:
          type: string
          description: Timezone for the meeting
        eventStartTime:
          type: string
          format: date-time
          description: Start time of the event
        eventEndTime:
          type: string
          format: date-time
          description: End time of the event
        eventId:
          type: string
          description: Calendar event ID
        eventUrl:
          type: string
          format: uri
          description: URL to the calendar event
        rescheduleOrCancelUrl:
          type: string
          format: uri
          description: URL to reschedule or cancel the event
        userId:
          type: integer
          description: User ID (optional)
        scheduledUserEmail:
          type: string
          format: email
          description: Email of the scheduled user (optional)
        meetingNotes:
          type: string
          description: Meeting notes (optional)
      required:
        - fullName
        - email
        - timezone
        - eventStartTime
        - eventEndTime
    PaymentValue:
      type: object
      properties:
        paymentId:
          type: string
          description: Stripe payment ID
        stripeCustomerId:
          type: string
          description: Stripe customer ID (optional)
        stripeCustomerUrl:
          type: string
          format: uri
          description: URL to Stripe customer dashboard (optional)
        stripePaymentUrl:
          type: string
          format: uri
          description: URL to Stripe payment dashboard (optional)
        totalAmount:
          type: integer
          description: Total amount in cents (optional)
        currency:
          type: string
          description: Currency code (optional)
        email:
          type: string
          format: email
          description: Customer email (optional)
        discountCode:
          type: string
          description: Discount code used (optional)
        status:
          type: string
          description: Payment status (optional)
        stripeSubscriptionId:
          type: string
          description: Stripe subscription ID (optional)
      required:
        - paymentId
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        Enter your [Fillout API
        key](https://build.fillout.com/home/settings/developer). Format: Bearer
        <api_key>

````