Get Folder Information

Retrieves details for a folder, including the first 100 entries in the folder.

To fetch more items within the folder, please use the Get items in a folder endpoint.

Basic Parameters

Parameter	Description
Folder ID	The unique identifier that represent a folder.

Advanced Parameters

Parameter	Description
Box API	The URL, and optional password, for the shared link of this item. This header can be used to access items that have not been explicitly shared with a user. Use the format shared_link=[link] or if a password is required then use shared_link=[link]&shared_link_password=[password].
Ensure Item Has Changed	Ensures an item is only returned if it has changed. 0 - not changed, 1 - changed.
Fields	A comma-separated list of attributes to include in the response. This can be used to request fields that are not normally returned in a standard response.

Example Output

{
    "content_created_at": "2012-12-12T10:53:43-08:00",
    "content_modified_at": "2012-12-12T10:53:43-08:00",
    "created_at": "2012-12-12T10:53:43-08:00",
    "created_by": {
        "id": "11446498",
        "login": "ceo@example.com",
        "name": "Aaron Levie",
        "type": "user"
    },
    "description": "Legal contracts for the new ACME deal",
    "etag": "1",
    "folder_upload_email": {
        "access": "open",
        "email": "upload.Contracts.asd7asd@u.box.com"
    },
    "id": "12345",
    "item_collection": {
        "entries": [
            {
                "etag": "1",
                "file_version": {
                    "id": "12345",
                    "sha1": "134b65991ed521fcfe4724b7d814ab8ded5185dc",
                    "type": "file_version"
                },
                "id": "12345",
                "name": "Contract.pdf",
                "sequence_id": "3",
                "sha1": "85136C79CBF9FE36BB9D05D0639C70C265C18D37",
                "type": "file"
            }
        ],
        "limit": 1000,
        "offset": 2000,
        "order": [
            {
                "by": "type",
                "direction": "ASC"
            }
        ],
        "total_count": 5000
    },
    "item_status": "active",
    "modified_at": "2012-12-12T10:53:43-08:00",
    "modified_by": {
        "id": "11446498",
        "login": "ceo@example.com",
        "name": "Aaron Levie",
        "type": "user"
    },
    "name": "Contracts",
    "owned_by": {
        "id": "11446498",
        "login": "ceo@example.com",
        "name": "Aaron Levie",
        "type": "user"
    },
    "parent": {
        "etag": "1",
        "id": "12345",
        "name": "Contracts",
        "sequence_id": "3",
        "type": "folder"
    },
    "path_collection": {
        "entries": [
            {
                "etag": "1",
                "id": "12345",
                "name": "Contracts",
                "sequence_id": "3",
                "type": "folder"
            }
        ],
        "total_count": 1
    },
    "purged_at": "2012-12-12T10:53:43-08:00",
    "sequence_id": "3",
    "shared_link": {
        "access": "open",
        "download_count": 3,
        "download_url": "https://www.box.com/shared/static/rh935iit6ewrmw0unyul.jpeg",
        "effective_access": "company",
        "effective_permission": "can_download",
        "is_password_enabled": true,
        "permissions": {
            "can_download": true,
            "can_edit": false,
            "can_preview": true
        },
        "preview_count": 3,
        "unshared_at": "2018-04-13T13:53:23-07:00",
        "url": "https://www.box.com/s/vspke7y05sb214wjokpk",
        "vanity_name": "my_url",
        "vanity_url": "https://acme.app.box.com/v/my_url/"
    },
    "size": 629644,
    "trashed_at": "2012-12-12T10:53:43-08:00",
    "type": "folder"
}

Workflow Library Example

Get Folder Information with Box and Send Results Via Email

Preview this Workflow on desktop