# POST /api/v1/reports/custom is deprecated

BambooHR API deprecated POST /api/v1/reports/custom without giving a shutdown date yet.

- API: BambooHR API (*.bamboohr.com)
- Kind: Endpoint removal
- Announced: March 18, 2026
- Takes effect: no date given yet
- Calls after that day: fail
- Calls it hits: `POST /api/v1/reports/custom`
- Source: [Announcement](https://documentation.bamboohr.com/docs/past-changes-to-the-api)
- Page: https://www.okapi.bot/providers/bamboohr-api/breaking-changes/post-api-v1-reports-custom-is-deprecated/

## What to use instead

Use Get Data from Dataset v2, POST /api/v2/datasets/{datasetName}/data; GET /api/v1/custom-reports/legacy-field-map maps the old field identifiers.

## BambooHR API's words

> We marked two legacy report endpoints as deprecated in our OpenAPI documentation and added guidance directing consumers to their newer alternatives: - POST /api/v1/reports/custom → Get Data from Dataset v2 at POST /api/v2/datasets/{datasetName}/data - GET /api/v1/reports/{id} → Get Report by ID at GET /api/v1/custom-reports/{reportId}