Skip to main content
Question

Access Statistics on Files in Folders

  • May 21, 2025
  • 14 replies
  • 43 views
C
Forum|alt.badge.img

Is there any way to get access numbers for an individual file within a folder using the SDK?

I'm only seeing file downloads and previews availible for share links. As a user on the web client these numbers are visible to me so it's strange that these figures aren't visible through the file box.object.file module (or anywhere else). I know that these figures are availible in bulk through the admin console, but I am trying to generate a daily report across a wide range of folders in my organization so automation here is key.

Thanks!

-Michiel

    14 replies

    C
    Forum|alt.badge.img

     Unfortunately, the aggregated file access stats are not available through the API. A workaround to get these stats would be using the Enterprise Events endpoint and requesting "PREVIEW" events. You would then have to filter the events returned for the specific files you need to track.

    C
    Forum|alt.badge.img

    Do the "PREVIEW" events just alert when a file is previewed (and then I would tally those server-side), or does it send the running total of previews? Is a prerequisite for this solution ownership of the file or any administrative privileges?

    C
    Forum|alt.badge.img

     You can only get the individual "PREVIEW" events through the API. The running total is only accessible through the Box web app. 

     

    You can get preview events in two ways. You can get preview events as the user who owns the file using the User Events endpoint and requesting "ITEM_PREVIEW". You can also get these preview events as the admin through the Enterprise Events endpoint and request "PREVIEW" events. 

    C
    Forum|alt.badge.img

    How do I access log stats for my files? Thank you!

    C
    Forum|alt.badge.img

    Any updates on this? Getting access stats still unavailable via API?

    C
    Forum|alt.badge.img

    This is a rather essential feature that is missing.

    Any news from the Box team on when that will be released ?

    C
    Forum|alt.badge.img

    Thank you for reaching out, and apologies for the miserable delay here. Our team is currently working on a UI Element that will allow you to display access stats for a file / folder in your own application, just as they currently show in our core web application (screenshot below). Would this help?

     

    Or are you specifically looking for an API that would return the access stats?

     

    BOX_27wsca87htw8aeyv2oag31tl9nbx8k2j.png

    C
    Forum|alt.badge.img
     
     
        Hi, for me as for developer API would be preferable than UI.
    C
    Forum|alt.badge.img

    Thanks for the feedback, Iga. We are working through the API right now, and will reach out to you when we have more to share. 

    C
    Forum|alt.badge.img

    are there any new developments in this API to get access stats a the files/folder level?

    C
    Forum|alt.badge.img

    any updates on this request? Is there or will there be shortly an api to access statistics of box files and folder? Thank you.

    C
    Forum|alt.badge.img

    any updates on this request? I really want to get file/folder level aggregated stats via API

    C
    Forum|alt.badge.img

    +1 any updates?

    C
    Forum|alt.badge.img

    +1 any updates?

     

    Terms of ServiceAccessibility statement