---
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-12-14** `1c19dcf99fec` — 2 breaking, 3 info
  - the response's body type/format changed from ``/`` to `object`/`` for status `400`
  - the response's body type/format changed from ``/`` to `object`/`` for status `404`
  - added the optional property `error` to the response with the `404` status
  - added the optional property `errors` to the response with the `400` status
  - …1 more
- **2025-12-12** `24b4a346840a` — 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
- **2025-11-26** `bb6f0434af12` — 2 breaking, 3 info
  - the response's body type/format changed from ``/`` to `object`/`` for status `400`
  - the response's body type/format changed from ``/`` to `object`/`` for status `404`
  - added the optional property `error` to the response with the `404` status
  - added the optional property `errors` to the response with the `400` status
  - …1 more
- …earlier changes not shown

[Full 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/1c19dcf99fec/schema)