---
title: "Get document collection details"
method: GET
path: "/v1/documents/collections/{collection_id}/"
tags: ["Document Collections"]
---

# Get document collection details

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

The endpoint returns detailed information about a specific collection, including all uploaded files and recognized documents with their categorization results.

## Response `200`

- DocumentCollectionDetail
  - `collection_id` string, required
  - `uploaded_files` UploadedFileBasic[], required
    - `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
    - `user_id` string, nullable — Truv user ID associated with this file
    - `external_user_id` string, nullable — External system user ID associated with this file
  - `documents` RecognizedDocumentBasic[], required
    - `document_id` string, required
    - `file_id` string, required
    - `document_type` 'PAYSTUB' | 'W2' | 'F1099' | 'F1040' | 'BANK_STATEMENT' | 'PASSPORT' | 'GREEN_CARD' | 'DRIVER_LICENSE' | 'LETTER_OF_VERIFICATION' | 'UTILITY_BILL' | 'LEASE_AGREEMENT' | 'INSURANCE_HOME_POLICY' | 'INSURANCE_AUTO_POLICY' | 'VOLUNTEER_LETTER' | 'OTHER', required
    - `document_subtype` 'F1099_MISC' | 'F1099_NEC' | 'F1099_DIV' | 'F1099_INT' | 'F1099_G' | 'F1099_R' | 'F_SSA1099' | 'VOL_TRANSCRIPT' | 'VOL_HOURS_LOG' | 'null', nullable
    - `status` 'successful' | 'failed' | 'rejected', required
    - `first_name` string, nullable
    - `last_name` string, nullable
    - `user_id` string, nullable — Truv user ID associated with this document
    - `external_user_id` string, nullable — External system user ID associated with this document
    - `start_page` integer, nullable, required
    - `end_page` integer, nullable, required
  - `users` CollectionUserResponse[], required
    - `id` string, required — Truv user ID
    - `external_user_id` string, nullable, required — External system user ID
    - `first_name` string, nullable, required — User's first name
    - `last_name` string, nullable, required — User's last name
  - `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.net/truv/apis/truv-api.md) · [All operations](https://skmtc.net/truv/apis/truv-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/truv/truv-api/revisions/6542a8962887/schema)