---
title: "List Datasets (v1.2)"
method: GET
path: "/api/v1_2/datasets"
tags: ["Datasets", "Public API"]
---

# List Datasets (v1.2)

`GET /api/v1_2/datasets`

Returns the catalog of datasets available for querying via the Datasets API. Each entry includes a machine-readable `name` (used as the `datasetName` path parameter in "Get Fields from Dataset (v1.2)" and "Get Data from Dataset (v2)") and a human-readable `label`. Use this endpoint to discover which datasets the current account has access to before building queries.

Datasets are queryable reporting datasets for the Datasets API. They are not the same as saved custom reports (`list-reports`), employee tabular table aliases (`list-tabular-fields`), or account list-field definitions (`list-list-fields`).

Note: Compared to "List Datasets (v1)", this version returns RFC 7807 `application/problem+json` error responses and includes an `X-Request-ID` correlation header.

OAuth Scopes: report

## Response `200`

Returns an object containing a `datasets` array of available datasets.

- object
  - `datasets` object[] — Array of available datasets
    - `name` string — Machine-readable dataset identifier, used as the datasetName path parameter in other Datasets endpoints.
    - `label` string — Human-readable display name for the dataset.

## Other responses

- `403` — Forbidden - insufficient permissions to access datasets.
- `500` — Internal server error while retrieving datasets.

---

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