---
title: "Получить содержимое папки"
method: GET
path: "/api/v1/files/folders/{id}/entries"
tags: ["Files"]
---

# Получить содержимое папки

`GET /api/v1/files/folders/{id}/entries`

## Request

- Base URL: `https://erp.akeda.ru`
- URL: `https://erp.akeda.ru/api/v1/files/folders/{id}/entries`
- Auth: one of:
  - HTTP bearer
  - OAuth 2 (authorization code, authorization URL `https://erp.akeda.ru/oauth2/authorize`, token URL `https://erp.akeda.ru/oauth2/token`, scopes: `akeda:delegate`)

Папки и файлы возвращаются одним списком вместе с путём до текущей папки и правами смотрящего.

## Path parameters

- `id` string, uuid, required

## Query parameters

- `q` string
- `sort` 'name' | 'size' | 'updated' | 'type'
- `order` 'asc' | 'desc'
- `limit` integer
- `offset` integer

## Headers

- `X-Tenant` string, required

## Response `200`

Содержимое папки

- FilesListing
  - `folder` FilesFolder, required
    - `id` string, uuid, required
    - `parent_id` string, uuid
    - `root_id` string, uuid, required
    - `depth` integer, required
    - `name` string, required
    - `kind` 'shared' | 'personal', required: Личное хранилище принадлежит своему владельцу целиком
    - `icon` string, required
    - `color` string, required
    - `description` string, required
    - `is_restricted` boolean, required: Закрытое хранилище видно только участникам его списка
    - `break_inheritance` boolean, required: Права хранилища на эту папку не действуют
    - `business_id` string, uuid, required
    - `owner_id` integer, required
    - `created_by` integer, required
    - `trashed_at` string, date-time
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `can_read` boolean, required
    - `can_write` boolean, required
    - `can_share` boolean, required: Право выпускать внешние ссылки; из открытости хранилища не следует
    - `can_manage` boolean, required
    - `is_favorite` boolean, required
    - `folder_count` integer, required
    - `file_count` integer, required
    - `size_bytes` integer, required
  - `path` FilesBreadcrumb[], required
    - `id` string, uuid, required
    - `name` string, required
  - `entries` FilesEntry[], required
    - `kind` 'folder' | 'file', required
    - `folder` FilesFolder
      - `id` string, uuid, required
      - `parent_id` string, uuid
      - `root_id` string, uuid, required
      - `depth` integer, required
      - `name` string, required
      - `kind` 'shared' | 'personal', required: Личное хранилище принадлежит своему владельцу целиком
      - `icon` string, required
      - `color` string, required
      - `description` string, required
      - `is_restricted` boolean, required: Закрытое хранилище видно только участникам его списка
      - `break_inheritance` boolean, required: Права хранилища на эту папку не действуют
      - `business_id` string, uuid, required
      - `owner_id` integer, required
      - `created_by` integer, required
      - `trashed_at` string, date-time
      - `created_at` string, date-time, required
      - `updated_at` string, date-time, required
      - `can_read` boolean, required
      - `can_write` boolean, required
      - `can_share` boolean, required: Право выпускать внешние ссылки; из открытости хранилища не следует
      - `can_manage` boolean, required
      - `is_favorite` boolean, required
      - `folder_count` integer, required
      - `file_count` integer, required
      - `size_bytes` integer, required
    - `file` FilesFile
      - `id` string, uuid, required
      - `folder_id` string, uuid, required
      - `root_id` string, uuid, required
      - `name` string, required
      - `external_url` string, uri: HTTP(S)-адрес внешнего ярлыка; отсутствует у обычных файлов
      - `extension` string, required
      - `mime_type` string, required
      - `size_bytes` integer, required
      - `version_no` integer, required
      - `version_id` string, uuid
      - `owner_id` integer, required
      - `created_by` integer, required
      - `updated_by` integer
      - `trashed_at` string, date-time
      - `created_at` string, date-time, required
      - `updated_at` string, date-time, required
      - `scan_status` 'pending' | 'scanning' | 'clean' | 'infected' | 'skipped' | 'error', required: skipped — содержимое крупнее порога проверки: оно выдаётся, но честно помечено непроверенным
      - `scan_verdict` string
      - `preview_status` 'pending' | 'processing' | 'ready' | 'unsupported' | 'error', required
      - `has_thumbnail` boolean, required
      - `is_favorite` boolean, required
      - `folder_name` string
      - `path` FilesBreadcrumb[]
        - `id` string, uuid, required
        - `name` string, required
  - `total` integer, required

## Other responses

- `401`: Сессия, ключ или кабинет не подтверждены
- `403`: Текущая роль не имеет требуемого права
- `404`: Запись не найдена или не видима текущему пользователю

---

[API](https://skmtc.dev/akeda/apis/akeda-erp-client-api.md) · [All operations](https://skmtc.dev/akeda/apis/akeda-erp-client-api/llms.txt) · [OpenAPI document](https://skmtc.dev/akeda/apis/akeda-erp-client-api/revisions/a99574d597cc?raw)