---
title: "Get Company Report"
method: GET
path: "/api/v1/reports/{id}"
tags: ["Reports", "Public API"]
deprecated: true
---

# Get Company Report

`GET /api/v1/reports/{id}`

> **Deprecated.**

**Deprecated. Use Custom Reports > Get Report by ID instead.**

Returns the data from an existing saved custom report. Non-admins can find these reports in My Reports. Admins can find them in Custom Reports under the My Reports and Company Reports tabs. The report ID can be found by hovering over the report name in BambooHR and noting the ID in the URL. Standard Reports are not available via this endpoint, and report IDs are company-specific.

The caller must have permission to view or access the report. The `format` query parameter is case-insensitive (`json`, `JSON`, `Json` are all accepted). If `format` is omitted, the output format is inferred from the `Accept` header, but only these exact values are supported: `application/json`, `text/xml`, `text/csv`, `application/pdf`, `application/vnd.ms-excel`. Any other `Accept` value (including `application/xml` and `*/*`) returns 404.

OAuth Scopes: report

## Path parameters

- `id` integer, required

## Query parameters

- `format` 'json' | 'xml' | 'csv' | 'xls' | 'pdf'
- `fd` 'yes' | 'no'
- `onlyCurrent` boolean

## Headers

- `Accept` 'application/json' | 'text/xml' | 'text/csv' | 'application/pdf' | 'application/vnd.ms-excel'

## Response `200`

Report data in the requested format. For JSON, returns an object with a `title` string, a `fields` array (each element has `id`, `type`, and `name`), and an `employees` array (each element has `id` plus one key per report field). For XML (`text/xml`), returns a `<report>` document. For CSV/XLS/PDF, returns file content with the appropriate content-type header.

- object
  - `title` string — The report title.
  - `fields` object[] — Metadata for each field included in the report.
    - `id` string — The field ID.
    - `type` string — The field data type.
    - `name` string — The human-readable field label.
  - `employees` object[] — One object per employee. Each object contains an `id` property plus one key per report field.
    - `id` string — The internal employee ID.

## Other responses

- `403` — Access denied. The authenticated user does not have permission to view this report.
- `404` — Not found. Returned when the report ID does not exist or belongs to a different company, when an unsupported `format` value is supplied (e.g. `?format=bogus`), or when `format` is omitted and the `Accept` header is not one of the supported exact values (`application/json`, `text/xml`, `text/csv`, `application/pdf`, `application/vnd.ms-excel`).

---

[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)