---
title: "List sandbox documents"
method: GET
path: "/v1/sandbox/documents/"
tags: ["Sandbox"]
---

# List sandbox documents

`GET /v1/sandbox/documents/`

## Request

- Base URL: `https://prod.truv.com`
- URL: `https://prod.truv.com/v1/sandbox/documents/`
- Auth: API key in header `X-Access-Client-Id` and API key in header `X-Access-Secret`

Cursor-paginated list of your sandbox document library, newest first.

## Query parameters

- `cursor` string
- `page_size` integer

## Response `200`

- SandboxDocumentList: A cursor-paginated page of sandbox document library entries.
  - `results` SandboxDocument[], required: Library entries, newest first.
    - `id` string: Unique identifier of the library entry. This is the value a scenario payload references as `document_id`.
    - `uploaded_file` SandboxUploadedFile: The file half of a library entry.
      - `file_id` string: Unique identifier of the file.
      - `filename` string: Name the entry is addressed by.
      - `mime_type` 'application/pdf' | 'image/jpeg' | 'image/png' | 'image/tiff' | 'image/webp' | 'image/x-ms-bmp' | 'image/heic' | 'image/heif': Mimetype detected from the uploaded bytes.
      - `size` integer: Size of the stored file in bytes.
      - `md5` string: MD5 hash of the file bytes.
      - `file` string, uri, nullable: Short-lived pre-signed URL over the stored file, minted fresh on every read.
      - `status` 'successful' | 'invalid' | 'duplicate' | 'failed': File-level processing outcome the entry declares.
      - `validations` object: Per-check validation results the entry declares.
      - `last_error` string: Message surfaced for a failed file.
    - `documents` SandboxRecognizedDocument[]: Test metadata describing the documents in the file, used by document-upload scenarios.
      - `document_type` string, required: Type of the document: `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`, `PCS_ORDERS` or `OTHER`. Accepted case-insensitively and returned uppercase.
      - `document_subtype` string, nullable: Subtype of the document, accepted case-insensitively and returned uppercase. A `F1099` carries one of `F1099_B`, `F1099_DIV`, `F1099_G`, `F1099_INT`, `F1099_K`, `F1099_MISC`, `F1099_NEC`, `F1099_R`, `F_SSA1099`; a `VOLUNTEER_LETTER` one of `VOL_TRANSCRIPT`, `VOL_HOURS_LOG`. Other types carry none.
      - `identity` SandboxRecognizedDocumentIdentity: The identity the document metadata declares.
        - `full_name` string, nullable: Full name on the document.
        - `first_name` string, nullable: First name on the document.
        - `last_name` string, nullable: Last name on the document.
        - `ssn` string, nullable: SSN on the document. Must be synthetic, with an area number of 900-999.
      - `company_name` string, nullable: Employer named on the document.
      - `start_page` integer, nullable: First page of the document inside the file.
      - `end_page` integer, nullable: Last page of the document inside the file.
    - `created_at` string, date-time: Time when the entry was created.
    - `updated_at` string, date-time: Time when the entry was last updated.
  - `next` string, uri, nullable: Opaque URL of the next page, or null on the last page.

## Other responses

- `401`: HTTP 401 Unauthorized
- `403`: The key is not a sandbox key.
- `429`: HTTP 429 Too Many Requests

## Changes

- **2026-10-06** `07068044e23d`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/truv/apis/truv-api/changes/v1/sandbox/documents/get.md)

---

[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)