# Return file or directory information

This function returns the information for a specified file or directory.



When you disable the File Storage role, the system  this function.

Endpoint: GET /Fileman/get_file_information
Version: 11.134.0.5
Security: BasicAuth

## Query parameters:

  - `path` (string, required)
    The directory from which to list files.
    Example: "public_html"

  - `check_for_leaf_directories` (integer)
    Whether to flag directories that contain subdirectories.

*  - Flag directories that contain subdirectories.
*  - Do  flag directories that contain subdirectories.
    Enum: 0, 1

  - `include_mime` (integer)
    Whether to return the file's MIME type.

*  - Return the file's MIME type.
*  - Do  return the file's MIME type.
    Enum: 0, 1

  - `include_permissions` (integer)
    Whether to parse the file owner's read and write permissions.

*  - Parse the file owner's read and write permissions.
*  - Do  parse the file owner's read and write permissions.
    Enum: 0, 1

  - `show_hidden` (integer)
    Whether to include hidden files in the output.

*  - Include hidden files.
*  - Do  include hidden files.
    Enum: 0, 1

## Response 200 fields (application/json):

  - `apiversion` (integer)
    The version of the API.
    Example: 3

  - `func` (string)
    The name of the method called.
    Example: "get_file_information"

  - `module` (string)
    The name of the module called.
    Example: "Fileman"

  - `result` (object)

  - `result.data` (object)

  - `result.data.absdir` (string)
    The path to the user's home directory.
    Example: "/home/user"

  - `result.data.ctime` (integer)
    The file's creation time, Unix time format.
    Example: 1400573272

  - `result.data.exists` (integer)
    Whether the file exists in the directory.
*  - Exists.
*  - Does  exist.
    Enum: 0, 1

  - `result.data.file` (string)
    The filename.
    Example: "cgi-bin"

  - `result.data.fullpath` (string)
    The file's full filepath.
    Example: "/home/user/public_html/cgi-bin"

  - `result.data.gid` (integer)
    The file owner's system group ID.
    Example: 503

  - `result.data.humansize` (string)
    The file's formatted size, followed by one of the following symbols:
*  - kilobytes
*  - megabytes
*  - gigabytes
    Example: "5 KB"

  - `result.data.isleaf` (integer)
    Whether the directory contains subdirectories.
*  - Contains subdirectories.
*  - Does  contain subdirectories.
    Enum: 0, 1

  - `result.data.mimename` (string)
    The file's MIME name.
    Example: "publichtml"

  - `result.data.mimetype` (string)
    The file's MIME type.
    Example: "text/plain"

  - `result.data.mode` (string)
    The file's textual permissions in [Unix format](https://en.wikipedia.org/wiki/File-system_permissions#Notation_of_traditional_Unix_permissions).
    Example: "16872"

  - `result.data.mtime` (integer)
    The file's last modification time, in Unix time format.
    Example: 1400573272

  - `result.data.nicemode` (integer)
    The file's numerical permissions in [octal notation](https://en.wikipedia.org/wiki/File-system_permissions#Notation_of_traditional_Unix_permissions).
    Example: 755

  - `result.data.path` (string)
    The file's path.
    Example: "/home/user/public.html"

  - `result.data.rawmimename` (string)
    The file's raw MIME name.
    Example: "text/plain"

  - `result.data.rawmimetype` (string)
    The file's raw MIME type.
    Example: "text/plain"

  - `result.data.read` (integer)
    Whether the file is readable. The function only returns this value if you set the  value to 1.
*  - Readable.
*  -  readable.
    Enum: 0, 1

  - `result.data.size` (integer)
    The file's size, in bytes.
    Example: 4096

  - `result.data.type` (string)
    The item's type.
*  - File.
*  - Directory.
*  - Character special device.
*  - Block special device.
*  - Named pipe.
*  - Symbolic link.
*  - Unix domain socket.
    Enum: "file", "dir", "char", "block", "fifo", "link", "socket"

  - `result.data.uid` (integer)
    The file owner's system user ID.
    Example: 502

  - `result.data.write` (integer)
    Whether the file is writable. The function only returns this value if you set the  value to 1 .
*  - Writable.
*  - Not writable.
    Enum: 0, 1

  - `result.errors` (array,null)
    List of errors if the API failed.

  - `result.messages` (array,null)
    List of messages generated by the API.

  - `result.metadata` (object)

  - `result.status` (integer)
    *  - Success.
*  - Failed. Check the errors field for more details.
    Enum: 0, 1

  - `result.warnings` (array,null)
    List of warnings generated by the API. Warnings describe non-critical failures or other problematic conditions noted while running a API.