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

# Get a file upload processing steps for that uploadId

> Get a file upload processing steps for that uploadId



## OpenAPI

````yaml get /prod/v1/uploads/{uploadId}
openapi: 3.0.0
info:
  title: Public API
  description: >-

    ### Welcome to fileAI’s Public API Documentation.

    This API allows users to check the health of the system, upload and manage
    files, and manage AI Schemas.

    Should you have any questions, please reach out to fileAI via the “Contact a
    Developer” link below.



    [Contact a Developer](mailto:support@file.ai)



    ### Prerequisites


    Before using our API, please ensure you complete the following prerequisites

    - You must have a fileAI account. Sign up or login
    [here](https://orion.file.ai/en/sign-up)

    - You must have an API Key. After creating your fileAI account, you can
    generate your API Key. Refer to the Authentication section below for more
    details.



    ### Authentication

    All API requests require an API key for authentication.

    - To obtain your API key, please log in to your fileAI account and navigate
    to Project Settings in your dashboard

    - Keep your API key secure and do not share it publicly.


    ![Authentication](https://fileai-static-assets.s3.us-west-2.amazonaws.com/public-api-service/authentication.png)


    ### How to Use Your API Key

    Once you have your API key:

    - Click the Authorize button on the top-right of this page

    - Enter your API Key under Value

    - Click Authorize to start making authenticated requests directly from the
    documentation


    ![How to Use Your API
    Key](https://fileai-static-assets.s3.us-west-2.amazonaws.com/public-api-service/how-to-use-api-keys.png)
        
  version: '1.0'
  contact: {}
servers:
  - url: https://api.orion.file.ai
security: []
tags:
  - name: Public API V1
paths:
  /prod/v1/uploads/{uploadId}:
    get:
      tags:
        - Public API V1
      summary: Get a file upload processing steps for that uploadId
      description: Get a file upload processing steps for that uploadId
      operationId: PublicAPIController_getFileUploadProcessingSteps
      parameters:
        - name: uploadId
          required: true
          in: path
          schema:
            type: string
      responses:
        '200':
          description: Get a file upload processing steps for that uploadId
          content:
            application/json:
              example:
                statuses:
                  - status: completed
                    step: processing_started
                    timestamp: '2025-06-11T10:30:30Z'
                  - status: completed
                    step: fraud_detection
                    timestamp: '2025-06-11T10:31:00Z'
                files:
                  - fileId: 53d6a0b1-2a8d-4ed9-9e6a-ceaef7ca3908
                    fileName: file1.jpg
                    fileType: image/jpeg
                    fileSize: 261928
                    fileStoragePath: path/to/file1.jpg
                    fileHash: >-
                      be3ef5fbb21e31c1281300b23b1c918a8ba54427c799aea21865f68d5efd01b7
                    uploadId: f2538513-f0b9-4aa8-9c57-bc0a85c77de6
                    status: processed
                    currency: USD
                    summary: Example file
                    duplicateToFileId: null
                    referenceId: 1e70a5e860
                    isDuplicate: false
                    isEmbedded: false
                    schemaId: 6835aca6030a79ffaabca742
                    fileClass: Receipt
                    fileContactId: 6835aca2281d9ed1bab90b11
                    fileContactName: Example Company
                    createdAt: '2025-05-27T12:14:24.258Z'
                    updatedAt: '2025-05-27T12:14:24.258Z'
              schema:
                type: object
                properties:
                  statuses:
                    type: array
                    items:
                      type: object
                      properties:
                        status:
                          type: string
                        step:
                          type: string
                        timestamp:
                          type: string
                  files:
                    type: array
                    description: >-
                      For regular uploads: document objects. For ZIP uploads:
                      per-file status objects with uploadId, fileName, statuses,
                      and files (documents).
                    items:
                      type: object
        '207':
          description: >-
            Partial success — the ZIP was extracted but some files succeeded and
            some failed. Inspect each file's statuses array for per-file status.
          content:
            application/json:
              example:
                statuses:
                  - step: zip_extraction
                    status: completed
                    timestamp: '2025-06-11T10:30:30Z'
                files:
                  - uploadId: abc-123
                    fileName: invoice.pdf
                    fileType: application/pdf
                    statuses:
                      - step: file_uploaded
                        status: completed
                        timestamp: '2025-06-11T10:30:31Z'
                      - step: processing_started
                        status: completed
                        timestamp: '2025-06-11T10:30:32Z'
                    files:
                      - fileId: doc-001
                        uploadId: abc-123
                        fileName: invoice.pdf
                        status: processed
                  - fileName: unsupported.exe
                    fileType: application/x-dosexec
                    statuses:
                      - step: processing_failed
                        status: error
                        errorReason: Unsupported file type
                  - fileName: corrupt.pdf
                    fileType: application/pdf
                    statuses:
                      - step: processing_failed
                        status: error
                        errorReason: Upload failed
        '401':
          description: Invalid API key | API key is missing
          content:
            application/json:
              example:
                message: Invalid API key | API key is missing
                error: Unauthorized
                statusCode: 401
              schema:
                type: object
                properties:
                  message:
                    type: string
                  error:
                    type: string
                  statusCode:
                    type: number
        '429':
          description: Too Many Requests
          content:
            application/json:
              example:
                statusCode: 429
                message: Too Many Requests
              schema:
                type: object
                properties:
                  statusCode:
                    type: number
                  message:
                    type: string
      security:
        - x-api-key: []
components:
  securitySchemes:
    x-api-key:
      type: apiKey
      in: header
      name: x-api-key
      description: API key for authentication

````