---
title: "GET /documents/v2/files"
method: GET
path: "/documents/v2/files"
tags: ["files_v2"]
---

# GET /documents/v2/files

`GET /documents/v2/files`

## Query parameters

- `cursor` string
- `direction` 'next' | 'prev'
- `limit` integer
- `file_name` string, nullable
- `created_after` string, nullable
- `created_before` string, nullable

## Response `200`

List of files

- PaginatedResultFileMetadataResponse
  - `items` object[], required
    - `file_id` string, required — The ID of the file This ID is used to reference the file in parse, datasets, and other operations.
    - `file_name` string, nullable — The name of the file. This is taken from the multipart form data or the file metadata. It is not guaranteed to be unique, and it may not match the original file name.
    - `mime_type` 'application/pdf' | 'application/vnd.openxmlformats-officedocument.wordprocessingml.document' | 'application/vnd.openxmlformats-officedocument.presentationml.presentation' | 'application/vnd.apple.keynote' | 'image/jpeg' | 'text/plain' | 'text/html' | 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet' | 'application/vnd.ms-excel.sheet.macroEnabled.12' | 'application/vnd.ms-excel' | 'text/csv' | 'image/png', required
    - `file_size` integer, required — The file size in bytes. This is determined from the `Content-Length` header of the request, or from the file metadata. This is not guaranteed to be accurate, as the file may be compressed or encoded in a way that changes its size.
    - `checksum_sha256` string, required — The SHA256 checksum of the file. This is calculated from the file content and is used to verify the integrity of the file.
    - `created_at` string, required — The creation date and time of the file. This is in RFC 3339 format.
    - `labels` object — Labels submitted at the time of file upload. This is a map of label names to their values.
  - `has_more` boolean, required
  - `next_cursor` string, nullable
  - `prev_cursor` string, nullable

## Other responses

- `401` — Unauthorized. Invalid or missing credentials
- `403` — Forbidden. You do not have permission to access this resource
- `500` — Something went wrong on our side. Please reach out to support@tensorlake.ai for assistance.

---

[API](https://skmtc.net/tensorlakeai/apis/tensorlake-api.md) · [All operations](https://skmtc.net/tensorlakeai/apis/tensorlake-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tensorlakeai/tensorlake-api/revisions/fb161f7c0ab7/schema)