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

# Get Submission

> Returns one submission (checklist log) by id: its status, progress, score, submitter, answered items, and attachments. Requires the key's user to have access to the submission's workspace (the caller must be a member of that workspace). Use the `submission-records` endpoint to find submission ids.

Fetch a single submission by id — its status, progress, score, submitter, answered items, and attachments. Use [Get Submission Records](/api-reference/endpoints/reporting/submission-records) to discover submission ids, then read individual submissions here. The key's user must belong to the submission's workspace.


## OpenAPI

````yaml GET /api/v1/ops/workspaces/{workspaceId}/logs/{logId}
openapi: 3.1.0
info:
  title: Xenia Team API - Get Submission
  version: 1.0.0
  description: >-
    Retrieve a single submission (checklist log) by id, including its answered
    items, attachments, scores, and submitter.
servers:
  - url: https://api.xenia.team
security: []
paths:
  /api/v1/ops/workspaces/{workspaceId}/logs/{logId}:
    get:
      tags:
        - Reporting
      summary: Get Submission
      description: >-
        Returns one submission (checklist log) by id: its status, progress,
        score, submitter, answered items, and attachments. Requires the key's
        user to have access to the submission's workspace (the caller must be a
        member of that workspace). Use the `submission-records` endpoint to find
        submission ids.
      parameters:
        - in: path
          name: workspaceId
          required: true
          schema:
            type: string
            format: uuid
          description: Workspace the submission belongs to.
        - in: path
          name: logId
          required: true
          schema:
            type: string
            format: uuid
          description: The submission (checklist log) id.
        - in: query
          name: items
          required: false
          schema:
            type: string
            enum:
              - all
              - filtered
            default: all
          description: >-
            `all` returns every item; `filtered` applies the template's
            conditional-visibility rules.
        - in: query
          name: sectioned
          required: false
          schema:
            type: string
            enum:
              - 'true'
              - 'false'
            default: 'true'
          description: Group items by their template sections.
        - in: query
          name: viewReport
          required: false
          schema:
            type: string
            enum:
              - 'true'
              - 'false'
            default: 'false'
          description: Include report-only data such as flag categories and AI summaries.
        - in: query
          name: comments
          required: false
          schema:
            type: string
            enum:
              - 'true'
              - 'false'
            default: 'false'
          description: Include item comments.
        - in: query
          name: approvals
          required: false
          schema:
            type: string
            enum:
              - 'true'
              - 'false'
            default: 'false'
          description: Include approval workflow state.
      responses:
        '200':
          description: The submission, wrapped in the standard listing envelope.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    description: The full submission (checklist log).
                    properties:
                      id:
                        type: string
                        format: uuid
                      ChecklistId:
                        type: string
                        format: uuid
                        description: The template this submission was started from.
                      name:
                        type: string
                      status:
                        type: string
                        example: submitted
                        description: >-
                          e.g. Draft, submitted, Pending Approval, Approved,
                          Rejected.
                      progress:
                        type: number
                        description: Completion percentage.
                      score:
                        type:
                          - number
                          - 'null'
                      submitterName:
                        type:
                          - string
                          - 'null'
                      submitterEmail:
                        type:
                          - string
                          - 'null'
                      lastItemUpdatedAt:
                        type:
                          - string
                          - 'null'
                        format: date-time
                      TaskChecklistItems:
                        type: array
                        description: >-
                          The answered items, with answers, scores and
                          attachments.
                        items:
                          type: object
                  meta:
                    type: object
                    description: >-
                      Pagination keys are omitted for a single-record read
                      (serializes as {}).
                    properties: {}
              example:
                data:
                  id: b3f1c2a4-5d6e-4f70-8a91-2c3d4e5f6a7b
                  ChecklistId: a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d
                  name: Opening Checklist
                  status: submitted
                  progress: 100
                  score: 96
                  submitterName: John Doe
                  submitterEmail: john.doe@example.com
                  lastItemUpdatedAt: '2026-01-15T14:32:00.000Z'
                  TaskChecklistItems:
                    - id: item-uuid
                      ChecklistItemId: tmpl-item-uuid
                      type: passFail
                      answers:
                        - pass
                      score: 1
                      attachments: []
                meta: {}
        '401':
          description: Missing/invalid credentials.
          content:
            application/json:
              example:
                status: false
                code: 401
                error:
                  message: Invalid client credentials
        '403':
          description: >-
            The key is not authorized for this route, or its user lacks access
            to the workspace.
          content:
            application/json:
              example:
                status: false
                code: 403
                error:
                  message: 'Forbidden: API key not authorized for this route'
      security:
        - clientKey: []
          clientSecret: []
components:
  securitySchemes:
    clientKey:
      type: apiKey
      in: header
      name: x-client-key
    clientSecret:
      type: apiKey
      in: header
      name: x-client-secret

````