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

# List Datasets (v1)

`GET /api/v1/datasets`

> **Deprecated.**

Deprecated. Use "List Datasets (v1.2)" instead.

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") and a human-readable `label`. Use this endpoint to discover which datasets the current account has access to before building queries.

The response includes `Deprecation` and `Link` headers pointing to the v1.2 successor endpoint.

OAuth Scopes: report

## Response `200`

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

- DatasetResponseV1
  - `datasets` DatasetV1[] — 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)