---
title: "List all files"
method: GET
path: "/projects/{project_id}:{branch}/files"
tags: ["Files"]
---

# List all files

`GET /projects/{project_id}:{branch}/files`

## Request

- Base URL: `https://api.lokalise.com/api2`
- URL: `https://api.lokalise.com/api2/projects/{project_id}:{branch}/files`
- Auth: API key in header `X-Api-Token`

Lists project files and associated key count. If there are some keys in the project that do not have a file association, they will be returned with filename `__unassigned__`.

Requires <code>read_files</code> OAuth access scope.

## Path parameters

- `project_id` string, required
- `branch` string, required

## Query parameters

- `filter_filename` string
- `limit` integer
- `page` integer

## Response `200`

OK

- object
  - `project_id` string
  - `files` Files[]
    - `file_id` number: A unique identifier of the file.
    - `filename` string: File name.
    - `key_count` number: Total number of keys, associated with this file.

---

[API](https://skmtc.dev/lokalise/apis/projects-with-branches.md) - [All operations](https://skmtc.dev/lokalise/apis/projects-with-branches/llms.txt) - [OpenAPI document](https://skmtc.dev/lokalise/apis/projects-with-branches/revisions/7ed3f978a361?raw)