---
metadata:
  - name: generator
    content: Diplodoc Platform v5.44.0
alternate:
  - https://yandex.ru/dev/disk-api/doc/en/reference/capacity.md
  - https://yandex.ru/dev/disk-api/doc/ru/reference/capacity.md
---
> **Documentation Index:** Fetch the complete configuration index at https://yandex.ru/dev/disk-api/doc/ru/llms.txt

# Данные о Диске пользователя

API возвращает общую информацию о Диске пользователя: доступный объем, адреса системных папок и т. п.


## Формат запроса {#format}

Запрос данных о Диске следует отправлять с помощью метода GET.

```no-highlight
https://cloud-api.yandex.net/v1/disk/
```

### Заголовок {#header}

```
Authorization: OAuth <token>
```

## Формат ответа {#response}

Если запрос был обработан без ошибок, API отвечает кодом `200 OK` и возвращает данные о Диске в теле ответа в объекте [Disk](https://yandex.ru/dev/disk-api/doc/ru/reference/response-objects.md#disk).

<!-- source: ru/_includes/reference/response-error.md -->
Если запрос вызвал ошибку, возвращается подходящий код ответа, а тело ответа содержит [описание ошибки](https://yandex.ru/dev/disk-api/doc/ru/reference/response-objects.md#error).
<!-- endsource: ru/_includes/reference/response-error.md -->

Пример ответа:

```json
{
  "trash_size": 4631577437,
  "total_space": 319975063552,
  "used_space": 26157681270,
  "system_folders":
  {
    "applications": "disk:/Приложения",
    "downloads": "disk:/Загрузки/"
  }
}
```

<!-- source: ru/_includes/reference/response-objects/id-link/disk-table.md -->
#|
|| **Элемент** | **Описание** ||
||`trash_size` |Объем файлов, находящихся в Корзине, в байтах. ||
||`total_space` |Общий объем Диска, доступный пользователю, в байтах. ||
||`used_space` |Объем файлов, уже хранящихся на Диске, в байтах. ||
||`system_folders` |
Абсолютные адреса системных папок Диска. Имена папок зависят от языка интерфейса пользователя в момент создания персонального Диска. Например, для англоязычного пользователя создается папка **Downloads**, для русскоязычного — **Загрузки** и т. д.

На данный момент поддерживаются следующие папки:
- `applications` — папка для файлов приложений;
- `downloads` — папка для файлов, загруженных из интернета (не с устройства пользователя).||
|#
<!-- endsource: ru/_includes/reference/response-objects/id-link/disk-table.md -->