---
title: "List recently uploaded files"
method: GET
path: "/files-api/v2/projects/{projectId}/files/list"
tags: ["Files"]
---

# List recently uploaded files

`GET /files-api/v2/projects/{projectId}/files/list`

This lists recently uploaded files, and returns a maximum of 100 files.

## Path parameters

- `projectId` string, required

## Query parameters

- `uriMask` string
- `fileTypes[]` FileType[]
- `lastUploadedAfter` string, YYYY-MM-DDThh:mm:ssZ
- `lastUploadedBefore` string, YYYY-MM-DDThh:mm:ssZ
- `orderBy` 'created' | 'fileUri' | 'lastUploaded' | 'created_asc' | 'created_desc' | 'fileUri_asc' | 'fileUri_desc' | 'lastUploaded_asc' | 'lastUploaded_desc'
- `limit` integer
- `offset` integer

## Response `200`

OK

- FilesAPIListFilesSuccessResponse
  - `response` object, required
    - `code` 'SUCCESS', required — Indicates whether the response was successful or what error has occured.
    - `data` object
      - `items` FilesAPIListFileItem[], required
        - `created` string, YYYY-MM-DDThh:mm:ssZ, required — The time and date of the first upload
        - `fileType` 'android' | 'csv' | 'doc' | 'docx' | 'gettext' | 'html' | 'idml' | 'ios' | 'java_properties' | 'json' | 'madcap' | 'markdown' | 'plain_text' | 'ppt' | 'pptx' | 'pres' | 'qt' | 'resx' | 'srt' | 'stringsdict' | 'xls' | 'xlsx' | 'xlsxTemplate' | 'xliff' | 'xml' | 'yaml', required — A unique identifier for the file type.
        - `fileUri` string, required — A unique identifier for the uploaded file
        - `hasInstructions` boolean, required — Whether translator instructions have been captured for the file.
        - `lastUploaded` string, YYYY-MM-DDThh:mm:ssZ, required — The time and date of the last upload
      - `totalCount` integer, required — The number of files that match your specified criteria

## Other responses

- `400` — Provided request parameters are invalid.
- `401` — Provided credentials are not valid.
- `429` — Too many simultaneous API requests.
- `500` — Unexpected error

---

[API](https://skmtc.dev/smartling/apis/smartling-rest-api-reference.md) · [All operations](https://skmtc.dev/smartling/apis/smartling-rest-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/smartling/smartling-rest-api-reference/revisions/2a73d11e9b98/schema)