---
title: "Lists files uploaded by a user in S3"
method: GET
path: "/v1/li/files"
tags: ["Bulk Routing API", "Bulk Multipass API", "Bulk Data Graph API", "Bulk Order Management API", "Bulk Analysis API"]
---

# Lists files uploaded by a user in S3

`GET /v1/li/files`

## Request

- Base URL: `https://api.cloud.precisely.com`
- URL: `https://api.cloud.precisely.com/v1/li/files`
- Auth: HTTP bearer

This endpoint retrieves a list of files uploaded by the specified user. The response includes the fileName, fileId and uploadTime of each uploaded file. Files are ordered newest first; use limit to return only the latest N files. Set includeColumns=true to also return the header column names of each file (delimiter is auto-detected); this reads every file and is slower.

## Query parameters

- `includeColumns` boolean
- `limit` integer

## Headers

- `X-Request-Id` string

## Response `200`

Successfully fetched list of uploaded files ( can be empty )

- UploadFileResultWrapper: Wrapper object for a list of file upload results.
  - `results` UploadFileResult[]: List of results for each uploaded file
    - `fileId` string: Unique identifier of the uploaded file
    - `fileName` string: Original name of the uploaded file
    - `uploadTime` string, date-time: Time the file was uploaded to S3
    - `columns` string[]: Header column names of the file. Present only when includeColumns=true and the header could be read

## Other responses

- `401`: Unauthorized: Invalid token
- `403`: Forbidden
- `429`: Too many requests
- `500`: Internal Server Error
- `503`: Service Unavailable

---

[API](https://skmtc.dev/precisely/apis/bulk-orchestrator-apis.md) · [All operations](https://skmtc.dev/precisely/apis/bulk-orchestrator-apis/llms.txt) · [OpenAPI document](https://skmtc.dev/precisely/apis/bulk-orchestrator-apis/revisions/989567dcef87?raw)