get
https://{companyDomain}.bamboohr.com/api/v1/employees//files/view
Lists the file categories and files visible to the caller for the specified employee. This is a metadata listing (names, sizes, permissions); to download a file's content use get-employee-file. The response format is controlled by the Accept header: send application/json for JSON or omit/send anything else for XML. Only categories and files the caller is permitted to see are included; employees viewing their own profile also see files shared with them. Returns 404 when the employee has no accessible categories.
OAuth Scopes: employee:file
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
Sample Response
<employee id="123">
<category id="1">
<name>New Hire Docs</name>
<file id="1234">
<name>Employee handbook</name>
<originalFileName>employee_handbook.doc</originalFileName>
<size>23552</size>
<dateCreated>2011-06-28 16:50:52</dateCreated>
<createdBy>John Doe</createdBy>
<shareWithEmployee>yes</shareWithEmployee>
</file>
</category>
<category id="112">
<name>Training Docs</name>
</category>
</employee>The API user does not have permission to access the requested employee's files.
The requested employee was not found, or the employee has no accessible file categories.