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

# Get File Details

> Retrieves details and processing status for one or more files by their IDs. A maximum of 1000 file IDs can be provided per request. This endpoint is useful for checking the processing status of recently uploaded files to determine when they are ready to query. Files that are not found or not accessible are returned with an error field instead of file details.

### Permissions

Requires `Vault API` permission.


## OpenAPI

````yaml /vault_api.json get /api/v1/vault/get_files
openapi: 3.0.1
info:
  title: Vault - Upload Documents
  description: >-
    The Vault Upload Documents API enables users to programmatically upload and
    manage documents within Vault projects. This API allows organizations to
    maintain projects with their own internal files for their users to use
    within the Harvey app.
  version: 1.0.0
  contact:
    email: support@harvey.ai
servers:
  - url: https://api.harvey.ai
    description: Harvey API server
security: []
paths:
  /api/v1/vault/get_files:
    get:
      tags:
        - Vault
      summary: Get File Details
      description: >-
        Retrieves details and processing status for one or more files by their
        IDs. A maximum of 1000 file IDs can be provided per request. This
        endpoint is useful for checking the processing status of recently
        uploaded files to determine when they are ready to query. Files that are
        not found or not accessible are returned with an error field instead of
        file details.
      operationId: getFiles
      parameters:
        - name: file_ids
          in: query
          required: true
          description: Comma-separated list of file IDs to retrieve details for.
          schema:
            type: array
            items:
              type: string
              format: uuid
          example: >-
            01936a5f-8289-703a-9962-42bf196ae611,01936a5f-82a2-708a-9df6-91d72c1cd26d
      responses:
        '200':
          description: File details retrieved successfully
          content:
            application/json:
              schema:
                type: object
                properties:
                  response:
                    type: object
                    properties:
                      content:
                        type: array
                        items:
                          $ref: '#/components/schemas/FileDetails'
              examples:
                getFiles:
                  summary: Example response for getting file details
                  value:
                    response:
                      content:
                        - file_id: 01936a5f-8289-703a-9962-42bf196ae611
                          file_name: Employment Agreement - John Smith.pdf
                          processing_status: ready_to_query
                          content_type: application/pdf
                          deleted_at: null
                        - file_id: 01936a5f-82a2-708a-9df6-91d72c1cd26d
                          file_name: Merger Agreement - Acme Corp.docx
                          processing_status: processing
                          content_type: >-
                            application/vnd.openxmlformats-officedocument.wordprocessingml.document
                          deleted_at: null
                        - file_id: 01936a5f-82de-7096-a7c2-021638a813ad
                          error: not_found
        '400':
          description: Bad request - Missing or empty file_ids
        '401':
          description: Unauthorized - Invalid or missing API token
        '429':
          description: Rate limit exceeded
        '500':
          description: Internal server error
      security:
        - bearerAuth: []
components:
  schemas:
    FileDetails:
      type: object
      properties:
        file_id:
          type: string
          format: uuid
          description: The unique identifier of the file.
          example: 01936a5f-8289-703a-9962-42bf196ae611
        file_name:
          type: string
          description: The name of the file. Only present when the file is found.
          example: Employment Agreement - John Smith.pdf
        processing_status:
          type: string
          description: >-
            The current processing status of the file. Only present when the
            file is found.
          enum:
            - uploaded
            - processing
            - ready_to_query
            - ready_to_review
            - recoverable_failure
            - unrecoverable_failure
          example: ready_to_query
        content_type:
          type: string
          nullable: true
          description: The MIME type of the file. Only present when the file is found.
          example: application/pdf
        deleted_at:
          type: string
          format: date-time
          nullable: true
          description: >-
            Timestamp when the file was deleted, or null if not deleted. Only
            present when the file is found.
          example: null
        error:
          type: string
          description: >-
            Error code indicating why the file could not be retrieved. Only
            present when the file is not found.
          example: not_found
      required:
        - file_id
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: JWT

````