Get Storage Item Information

Returns different types of information about an item based on query parameters.

Query parameters are mutually exclusive - only one operation type can be requested at a time:

  • list - Get file/folder listing (flat or deep). Requires a non-anonymous privileged user. Requires Artifactory Pro.
  • stats - Get file statistics (download count, last download info). Requires read privileges.
  • lastModified - Get last modified timestamp. Requires a valid user with deploy permissions. Requires Artifactory Pro.
  • properties - Get item properties
  • permissions - Get item permissions
  • No parameters - Get folder or file info

Since: 2.2.1 (folder/file info); 2.2.4 (file list); 2.2.5 (lastModified); 3.1.0 (stats)

Security: Requires a privileged user (can be anonymous) for basic folder/file/properties/permissions info. See per-operation notes above for stricter requirements.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required
length ≥ 1

Repository key

string
required
length ≥ 1

Item path within the repository

Query Params
string

Comma-separated list of property keys to retrieve. Mutually exclusive with other query parameters.

boolean

Returns the last modified item at the given path. If the given path is a folder, the latest last modified item is searched for recursively. Mutually exclusive with other query parameters.

boolean

Returns item statistics (download count, last download date, last downloader). Mutually exclusive with other query parameters.

boolean

Returns item permissions. Mutually exclusive with other query parameters.

boolean

Get a flat (the default) or deep listing of the files and folders. Mutually exclusive with other query parameters except listing-related parameters (deep, depth, listFolders, etc.).

integer
enum

Deep listing (0 or 1). Used with list parameter only.

Allowed:
integer

Optional depth to limit the results for deep listing. Used with list parameter only.

integer
enum

Include folders in listing (0 or 1). Used with list parameter only.

Allowed:
integer
enum

Include metadata timestamp values (0 or 1). Used with list parameter only.

Allowed:
integer
enum

Include folder root path (0 or 1). Used with list parameter only.

Allowed:
Headers
string
enum
Defaults to application/json

Generated from available response content types

Allowed:
Responses

Language
Credentials
URL
LoadingLoading…
Response
Choose an example:
application/json
application/vnd.org.jfrog.artifactory.storage.FolderInfo+json
application/vnd.org.jfrog.artifactory.storage.FileInfo+json
application/vnd.org.jfrog.artifactory.storage.ItemProperties+json
application/vnd.org.jfrog.artifactory.storage.ItemLastModified+json
application/vnd.org.jfrog.storage.StatsInfo+json
application/vnd.org.jfrog.artifactory.storage.FileList+json