---
title: "Get Fields from Dataset (v1)"
method: GET
path: "/api/v1/datasets/{datasetName}/fields"
tags: ["Datasets", "Public API"]
deprecated: true
---

# Get Fields from Dataset (v1)

`GET /api/v1/datasets/{datasetName}/fields`

> **Deprecated.**

Deprecated. Use "Get Fields from Dataset (v1.2)" instead.

Returns a paginated list of field descriptors for the specified dataset. Each field includes its machine-readable `name`, human-readable `label`, `parentType`, `parentName`, and `entityName`. Use the returned field `name` values in the `fields` array when querying data via "Get Data from Dataset". Use "List Datasets (v1.2)" to discover valid dataset names.

Pagination defaults to page 1 with 500 fields per page (maximum 1000). Out-of-range page numbers are clamped to the nearest valid page. The `next_page` and `prev_page` links in the pagination object are absolute URLs.

Error responses (400, 403, 500) return plain-text bodies, not JSON.

OAuth Scopes: report

## Path parameters

- `datasetName` string, required

## Query parameters

- `page` integer
- `page_size` integer

## Response `200`

Returns an object containing pagination metadata, the dataset name and label, and a `fields` array of field descriptors.

- DatasetFieldsResponse
  - `pagination` Pagination
    - `total_records` integer
    - `current_page` integer
    - `total_pages` integer
    - `next_page` string, nullable
    - `prev_page` string, nullable
  - `name` string — Machine-readable dataset identifier matching the requested datasetName.
  - `label` string — Human-readable display name for the dataset.
  - `fields` Field[] — Paginated array of field descriptors for this dataset.
    - `name` string — Machine-readable field identifier. Use this value in the `fields` array when querying data.
    - `label` string — Human-readable display name for the field.
    - `parentType` string — The type of the parent section (e.g. `page`, `table`).
    - `parentName` string — The name of the parent section this field belongs to.
    - `entityName` string — The entity name for the field, used in `showHistory` when querying historical table fields.

## Other responses

- `400` — The specified dataset name was not found. The body is a plain-text message.
- `403` — Insufficient permissions to access dataset fields. The body is a plain-text message.
- `500` — Internal server error while fetching the dataset configuration. The body is a plain-text message.

---

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