---
title: "Get Company Files and Categories"
method: GET
path: "/api/v1/files/view"
tags: ["Company Files", "Public API"]
---

# Get Company Files and Categories

`GET /api/v1/files/view`

Returns all company file categories and the files within each category that the requesting user is permitted to see. The response format is determined by the `Accept` request header: send `application/json` for JSON or omit it (or send `application/xml`) for XML.

OAuth Scopes: company_file

## Response `200`

List of company file categories and their visible files.

- object
  - `categories` object[] — List of company file categories.
    - `id` integer — Category ID.
    - `name` string — Category display name.
    - `canUploadFiles` 'yes' | 'no' — Whether the requesting user can upload files to this category.
    - `files` object[] — Files visible to the requesting user in this category.
      - `id` integer — File ID.
      - `name` string — File display name.
      - `originalFileName` string — Original uploaded filename including extension.
      - `size` string — File size in bytes.
      - `dateCreated` string — Timestamp of when the file was uploaded, in ISO 8601 format with UTC offset (e.g. `2025-02-11T22:30:07+0000`).
      - `createdBy` string — Full name of the user who uploaded the file.
      - `shareWithEmployees` 'yes' | 'no' — Whether the file is shared with all employees.
      - `canRenameFile` 'yes' | 'no' — Whether the requesting user can rename this file.
      - `canDeleteFile` 'yes' | 'no' — Whether the requesting user can delete this file.

## Other responses

- `403` — The API user does not have permission to access company files.

---

[API](https://skmtc.net/bamboohr/apis/bamboohr-api.md) · [All operations](https://skmtc.net/bamboohr/apis/bamboohr-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bamboohr/bamboohr-api/revisions/19ebf391a399/schema)