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

# Get submission status

> Retrieve the current status of a submission request by a requestId or device/deviceGroup.



## OpenAPI

````yaml get /api/v1/submission/status
openapi: 3.1.0
info:
  title: OpenAPI definition
  version: v0
servers:
  - url: https://api.udiconnect.io
    description: P36 UDI Hub API Server
security:
  - ApiKeyAuth: []
paths:
  /api/v1/submission/status:
    get:
      tags:
        - Submission Status
      summary: Get submission status
      description: >-
        Retrieve the current status of a submission request by a requestId or
        device/deviceGroup.
      operationId: getSubmissionStatus
      parameters:
        - name: id
          in: query
          description: Request ID of the submission
          required: false
          schema:
            type: string
            description: Request ID of the submission
            example: '1234567890'
          example: 1234567890
        - name: udiDevice
          in: query
          description: UDI Device identifier
          required: false
          schema:
            type: string
            description: UDI Device identifier
            example: '00308676965723'
          example: '00308676965723'
        - name: entityType
          in: query
          description: Type of UDI entity (DEVICE or DEVICE_GROUP)
          required: true
          schema:
            type: string
            description: Type of UDI entity (DEVICE or DEVICE_GROUP)
            enum:
              - DEVICE
              - DEVICE_GROUP
            example: DEVICE
          example: DEVICE
        - name: agency
          in: query
          description: Regulatory agency for the submission
          required: true
          schema:
            type: string
            description: Regulatory agency for the submission
            enum:
              - COMMON_DEVICE_DATA
              - FDA
              - EC
              - NMPA
              - MFDS
              - GDSN
              - SFDA
              - TFDA
              - TGA
              - HSA
            example: EC
          example: EC
      responses:
        '200':
          description: Submission status retrieved successfully
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/SubmissionStatusResponse'
              examples:
                Submission Status Example:
                  description: Submission Status Example
                  value: |-
                    {
                      "status": "PUBLISHED",
                      "statusUpdateTime": "2025-08-18T14:13:59.348",
                      "device": "00314167868558"
                    }
        '400':
          description: Bad Request - Invalid parameters provided
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                Bad Request Example:
                  description: Bad Request Example
                  value: |-
                    {
                      "errorType": "BAD_REQUEST",
                      "message": "Either requestId or udiDevice must be provided."
                    }
        '404':
          description: Not Found - No submission found for the provided identifiers
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                Not Found Example:
                  description: Not Found Example
                  value: |-
                    {
                      "errorType": "NOT_FOUND",
                      "message": "Invalid UDI entity type for the provided request ID."
                    }
        '500':
          description: >-
            Internal Server Error - An unexpected error occurred while
            retrieving the status
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
              examples:
                Internal Server Error Example:
                  description: Internal Server Error Example
                  value: |-
                    {
                      "timestamp": "string",
                      "status": 500,
                      "error": "Internal Server Error",
                      "message": "string"
                    }
components:
  schemas:
    SubmissionStatusResponse:
      type: object
      description: Status of a submission
      properties:
        status:
          type: string
          description: Current status of the submission
          enum:
            - IN_SUBMISSION
            - TECHNICAL_SUBMISSION_ERROR
            - SUBMISSION_REJECTED
            - SUBMITTED
            - PUBLISHED
            - LATENT
          example: SUBMITTED
        statusUpdateTime:
          type: string
          format: date-time
          description: Timestamp of the last status update
          example: '2023-10-01T12:00:00Z'
        device:
          type: string
          description: Device identifier associated with the submission
          example: '00308676965723'
        deviceGroup:
          type: string
          description: Device group identifier associated with the submission
          example: 439990237188JM
      title: Submission Status
    ErrorResponse:
      type: object
      properties:
        errorType:
          type: string
          description: Type of error
          enum:
            - BAD_REQUEST
            - NOT_FOUND
          example: BAD_REQUEST
        message:
          type: string
          description: Error message
          example: Invalid request parameters
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      name: Authorization
      in: header

````