---
title: "Get File Details"
method: GET
path: "/api/v1/vault/get_files"
tags: ["Vault"]
---

# Get File Details

`GET /api/v1/vault/get_files`

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.

## Query parameters

- `file_ids` string[], required

## Response `200`

File details retrieved successfully

- object
  - `response` object
    - `content` FileDetails[]
      - `file_id` string, uuid, required — The unique identifier of the file.
      - `file_name` string — The name of the file. Only present when the file is found.
      - `processing_status` 'uploaded' | 'processing' | 'ready_to_query' | 'ready_to_review' | 'recoverable_failure' | 'unrecoverable_failure' — The current processing status of the file. Only present when the file is found.
      - `content_type` string, nullable — The MIME type of the file. Only present when the file is found.
      - `deleted_at` string, date-time, nullable — Timestamp when the file was deleted, or null if not deleted. Only present when the file is found.
      - `error` string — Error code indicating why the file could not be retrieved. Only present when the file is not found.

## Other responses

- `400` — Bad request - Missing or empty file_ids
- `401` — Unauthorized - Invalid or missing API token
- `429` — Rate limit exceeded
- `500` — Internal server error

---

[API](https://skmtc.dev/harvey/apis/harvey-client-matter-api.md) · [All operations](https://skmtc.dev/harvey/apis/harvey-client-matter-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/harvey/harvey-client-matter-api/revisions/4a9e0925d49e/schema)