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

# Getting properties of files and directories (PROPFIND)

Use the [PROPFIND](http://www.webdav.org/specs/rfc4918.html#METHOD_PROPFIND) method to request:

- The amount of free/used space on Yandex Disk (according to [RFC 4331](http://www.ietf.org/rfc/rfc4331.txt)).
- A list of files and subdirectories contained in the directory (with the header `Depth: 1`).
- Other properties of a file or directory.

The list of all the properties supported in the context of the WebDAV protocol is provided in the [DAV Properties](http://www.webdav.org/specs/rfc4918.html#dav.properties) section of the protocol description. The XML elements that are used in requests and responses for properties are documented in the [protocol specification](http://www.webdav.org/specs/rfc4918.html#xml.element.definitions).

Examples of PROPFIND method requests are provided in the sections:

- [Free and used space](https://yandex.ru/dev/disk/doc/en/reference/propfind-free-space.md).
- [Directory contents](https://yandex.ru/dev/disk/doc/en/reference/propfind-folder-contents.md).
- [Properties of a file or directory](https://yandex.ru/dev/disk/doc/en/reference/propfind-resource-properties.md).