---
title: "List user files"
method: GET
path: "/v1/files"
tags: ["Files"]
---

# List user files

`GET /v1/files`

Retrieves a paginated list of files belonging to the authenticated user.

## Query parameters

- `take` number — The number of elements to retrieve
- `from` string — The id of the file from which to start the search

## Response `200`

Successfully retrieved the list of files.

- object
  - `data` FileResponse[], required — The list of files
    - union — The response for a file. Properties depend on the file type.
      - ImageResponse — The response for an image file
        - `id` string, required — The id of the file
        - `name` string, required — The name of the file
        - `task_id` string, nullable, required — The id of the task that generated this file, if any
        - `created_at` string, required — The creation date of the file in ISO format
        - `type` 'image/png' | 'image/jpeg' | 'image/webp', required — The MIME type of the file
        - `properties` object, required
          - `size` number, required — The size of the image in bytes
          - `width` number, required — The width of the image in pixels
          - `height` number, required — The height of the image in pixels
      - DocumentResponse — The response for a document file
        - `id` string, required — The id of the file
        - `name` string, required — The name of the file
        - `task_id` string, nullable, required — The id of the task that generated this file, if any
        - `created_at` string, required — The creation date of the file in ISO format
        - `type` 'application/pdf', required — The MIME type of the file
        - `properties` object, required
          - `size` number, required — The size of the document in bytes
          - `page_count` number, required — The number of pages in the document
  - `links` object, required
    - `previous` string, nullable, required — The URL to the previous page of results
    - `next` string, nullable, required — The URL to the next page of results

## Other responses

- `422` — Validation Error. Invalid query parameters.
- `429` — Rate Limit Exceeded.
- `5XX` — Internal Server Error.

---

[API](https://skmtc.dev/scan-documents/apis/scan-documents-api.md) · [All operations](https://skmtc.dev/scan-documents/apis/scan-documents-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/scan-documents/scan-documents-api/revisions/42f9aa9c3b27/schema)