> ## Documentation Index > Fetch the complete documentation index at: https://docs.iclear.ai/llms.txt > Use this file to discover all available pages before exploring further. # Get Submission Status > Get submission processing status. Provides a polling fallback when Ably real-time updates are not available. Returns the overall submission status along with per-asset details. Authentication: Requires X-API-Key header with valid API key. Raises: 404: If submission not found or not in the authenticated workspace. ## OpenAPI ````yaml get /api/submissions/{submission_id} openapi: 3.1.0 info: title: MediaMagic Verify Integrations API description: An API for MediaMagic Verify integrations. version: 1.0.0 servers: - url: https://api.northell.io/nhl/prod/mediamagic-verify-integrations description: prod security: [] paths: /api/submissions/{submission_id}: get: tags: - submissions summary: Get Submission Status description: >- Get submission processing status. Provides a polling fallback when Ably real-time updates are not available. Returns the overall submission status along with per-asset details. Authentication: Requires X-API-Key header with valid API key. Raises: 404: If submission not found or not in the authenticated workspace. operationId: get_submission_status_api_submissions__submission_id__get parameters: - name: submission_id in: path required: true schema: type: string format: uuid title: Submission Id responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/SubmissionStatusResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - apiKey: [] components: schemas: SubmissionStatusResponse: properties: submissionId: type: string format: uuid title: Submissionid description: Submission ID workflowId: anyOf: - type: string - type: 'null' title: Workflowid description: Workflow ID (None if not started) workspaceId: type: string format: uuid title: Workspaceid description: Workspace ID status: $ref: '#/components/schemas/SubmissionStatus' description: Submission status progressPercent: anyOf: - type: integer - type: 'null' title: Progresspercent description: Progress percentage (0-100) createdAt: type: string format: date-time title: Createdat description: Creation timestamp startedAt: anyOf: - type: string format: date-time - type: 'null' title: Startedat description: >- When the first of this submission's assets entered review (the earliest assets[].startedAt). Null while every asset is still queued. completedAt: anyOf: - type: string format: date-time - type: 'null' title: Completedat description: Completion timestamp errorMessage: anyOf: - type: string - type: 'null' title: Errormessage description: Error message if failed assets: items: $ref: '#/components/schemas/AssetStatusItem' type: array title: Assets description: Per-asset status details isRetryable: type: boolean title: Isretryable description: >- True iff at least one asset in this submission can be retried right now. default: false externalReference: anyOf: - $ref: '#/components/schemas/ExternalReference' - type: 'null' description: >- Structured reference to the external work item this submission originates from, as supplied at create time. None for direct callers. type: object required: - submissionId - workspaceId - status - createdAt - assets title: SubmissionStatusResponse description: Response model for submission status. HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError SubmissionStatus: type: string enum: - uploading - submitted - queued - processing - complete - failed - partial title: SubmissionStatus AssetStatusItem: properties: assetId: type: string format: uuid title: Assetid description: Asset ID versionGroupId: anyOf: - type: string format: uuid - type: 'null' title: Versiongroupid description: Version group ID versionNumber: type: integer title: Versionnumber description: Version number default: 1 processingStatus: $ref: '#/components/schemas/ComplianceStatus' description: >- This asset's own processing lifecycle state: 'queued' while it waits for a free review slot (assets are admitted a few at a time), 'processing' while the worker runs, then 'compliant' (no issues), 'in_review' (issues found), or 'failed'. Distinct from the submission-level status. issueCount: anyOf: - type: integer - type: 'null' title: Issuecount description: Total issues found, or None if not yet complete errorMessage: anyOf: - type: string - type: 'null' title: Errormessage description: >- Generic customer-facing failure summary (retryable vs not) when the asset's most recent job failed. The raw internal error is never exposed. errorType: anyOf: - type: string - type: 'null' title: Errortype description: >- Structured failure category (e.g. 'network_timeout', 'unhandled_exception'). Populated when the asset's most recent job failed. isRetryable: type: boolean title: Isretryable description: >- True if this asset can be retried right now via the per-asset retry endpoint. default: false retryCount: type: integer title: Retrycount description: >- How many times this asset has been retried (0 for the original attempt). default: 0 workflowId: anyOf: - type: string - type: 'null' title: Workflowid description: >- Temporal workflow id of this asset's most recent job, for support reference and lookup in the Temporal UI. None if no job row exists yet. tags: items: $ref: '#/components/schemas/TagSchema' type: array title: Tags description: Tags applied to this asset. startedAt: anyOf: - type: string format: date-time - type: 'null' title: Startedat description: >- When this asset actually entered review. Null while it is still 'queued' waiting for a free slot. On a retried asset this is the latest attempt's start, not the first. completedAt: anyOf: - type: string format: date-time - type: 'null' title: Completedat description: >- When this asset left review, for ANY outcome — so on a 'failed' asset this is the failure time, not a success time. Null until then, and cleared when the asset is retried. With startedAt this gives the actual processing duration. type: object required: - assetId - processingStatus title: AssetStatusItem description: |- Asset-level information within a submission status response. The retry fields (``errorMessage`` / ``errorType`` / ``isRetryable`` / ``retryCount``) come from the asset's most recent ``submission_jobs`` row. ``errorMessage`` is a generic customer-facing line — the raw classifier failure detail is never exposed. Internal classifier fields (``error_origin``, original-exception details, stack trace) are deliberately not exposed either — they live in the DB for engineering use only. ExternalReference: properties: system: type: string maxLength: 64 title: System description: >- Identifier of the external system that created the submission, e.g. 'optimizely-cmp'. ref: additionalProperties: true type: object title: Ref description: >- Opaque, system-specific reference payload the connector uses to correlate back (e.g. the originating task/step/sub-step ids). Serialized JSON must not exceed 4 KB — it is stored and echoed on every webhook, so keep it to identifiers, not documents. type: object required: - system - ref title: ExternalReference description: >- A structured reference to the external work item that originated a submission. Set by an integration connector at create time, returned on ``GET`` and echoed on the ``asset.processing.*`` webhook so a completion can be correlated back to its originating work item without connector-side correlation state. Distinct from the ingestion-channel ``source`` field. ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type input: title: Input ctx: type: object title: Context type: object required: - loc - msg - type title: ValidationError ComplianceStatus: type: string enum: - queued - processing - in_review - compliant - archived - failed title: ComplianceStatus TagSchema: properties: key: type: string title: Key description: Tag key/namespace, e.g. 'Campaign'. value: type: string title: Value description: Tag value/label, e.g. 'Summer'. type: object required: - key - value title: TagSchema description: A tag applied to an asset, as key/value. securitySchemes: apiKey: type: apiKey in: header name: X-API-Key description: 'Workspace-scoped API key. Format: sk_live_{64 hex chars}' x-default: sk_live_your_api_key_here ````