---
title: "Get uploaded file details"
method: GET
path: "/v1/documents/collections/{collection_id}/upload/{uploaded_file_id}/"
tags: ["Document Collections"]
---

# Get uploaded file details

`GET /v1/documents/collections/{collection_id}/upload/{uploaded_file_id}/`

## Request

- Base URL: `https://prod.truv.com`
- URL: `https://prod.truv.com/v1/documents/collections/{collection_id}/upload/{uploaded_file_id}/`
- Auth: API key in header `X-Access-Client-Id` and API key in header `X-Access-Secret`

The endpoint returns details about a specific uploaded file, including its processing status and any recognized documents.

## Response `200`

- UploadedFileDetail
  - `file_id` string, required
  - `filename` string, required
  - `mime_type` 'application/pdf' | 'image/jpeg' | 'image/png' | 'image/tiff' | 'image/webp' | 'image/x-ms-bmp' | 'image/heic' | 'image/heif', required
  - `validations` object, nullable
    - `is_viable_size` boolean, nullable: Whether the file size is within acceptable limits
    - `is_supported_type` boolean, nullable: Whether the file type is supported
    - `is_accessible` boolean, nullable: Whether the file is accessible
    - `is_valid` boolean, nullable: Overall validation status
    - `is_readable` boolean, nullable: Whether the file can be read
    - `is_unique` boolean, nullable: Whether the file is unique (not a duplicate)
  - `status` 'pending' | 'validating' | 'validated' | 'invalid' | 'duplicate' | 'processing' | 'successful' | 'failed', required
  - `file_url` string, uri, required
  - `user_id` string, nullable: Truv user ID associated with this file
  - `external_user_id` string, nullable: External system user ID associated with this file
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `401`: HTTP 401 Unauthorized
- `403`: HTTP 403 Forbidden
- `404`: HTTP 404 Not Found

---

[API](https://skmtc.dev/truv/apis/truv-api.md) - [All operations](https://skmtc.dev/truv/apis/truv-api/llms.txt) - [OpenAPI document](https://skmtc.dev/truv/apis/truv-api/revisions/e20fd88e9371?raw)