---
title: "List files by ID"
method: GET
path: "/file"
tags: ["files"]
---

# List files by ID

`GET /file`

Get list of file objects by ID.

-  PERMISSIONS (for private files): `api_file:read`

## Query parameters

- `id` string[]

## Response `200`

OK

- FileFile[] — unresolved $ref

## Other responses

- `400` — Bad Request
- `404` — Not Found

## Changes

- **2025-09-19** `10a1f7617754` — 2 breaking, 3 warning
  - the response's body type/format changed from `object`/`` to ``/`` for status `400`
  - the response's body type/format changed from `object`/`` to ``/`` for status `404`
  - removed the optional property `error` from the response with the `404` status
  - removed the optional property `errors` from the response with the `400` status
  - …1 more

[Change history](https://skmtc.dev/capensis/apis/canopsis-community-api/changes/file/get.md)

---

[API](https://skmtc.dev/capensis/apis/canopsis-community-api.md) · [All operations](https://skmtc.dev/capensis/apis/canopsis-community-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/capensis/canopsis-community-api/revisions/bbc46dbdcc32/schema)