---
title: "Get a dataset"
method: GET
path: "/v3/datasets/{dataset_api_id}"
tags: ["Function Accuracy"]
---

# Get a dataset

`GET /v3/datasets/{dataset_api_id}`

**Get a dataset**, including its columns and their roles.

## Path parameters

- `dataset_api_id` string, required

## Response `200`

The request has succeeded.

- GoldenDataSetGetResponse — Response containing a single golden data set
  - `dataset` GoldenDataSetSummary — Summary information about a golden data set
    - `id` string, required — Unique identifier of the dataset
    - `name` string, required — Name of the dataset
    - `description` string, nullable — Description of the dataset
    - `versionNum` integer, required — Current version number of the dataset
    - `columns` object, required — Map of column names to column information
    - `rowCount` integer, required — Number of rows in the dataset
    - `createdAt` string, date-time, required — Timestamp when the dataset was created
    - `updatedAt` string, date-time, required — Timestamp when the dataset was last updated
    - `audit` GoldenDataSetAudit — Audit information about who created and updated a dataset
      - `datasetCreatedBy` UserActionSummary
        - `userActionID` string, required — Unique identifier of the user action.
        - `userID` string — User's ID. Present for user-initiated actions.
        - `userEmail` string — User's email address. Present for user-initiated actions.
        - `apiKeyName` string — API key name. Present for API key-initiated actions.
        - `emailAddress` string — Email address. Present for email-initiated actions.
        - `createdAt` string, date-time, required — The date and time the action was created.
      - `datasetLastUpdatedBy` UserActionSummary
        - `userActionID` string, required — Unique identifier of the user action.
        - `userID` string — User's ID. Present for user-initiated actions.
        - `userEmail` string — User's email address. Present for user-initiated actions.
        - `apiKeyName` string — API key name. Present for API key-initiated actions.
        - `emailAddress` string — Email address. Present for email-initiated actions.
        - `createdAt` string, date-time, required — The date and time the action was created.
      - `versionCreatedBy` UserActionSummary
        - `userActionID` string, required — Unique identifier of the user action.
        - `userID` string — User's ID. Present for user-initiated actions.
        - `userEmail` string — User's email address. Present for user-initiated actions.
        - `apiKeyName` string — API key name. Present for API key-initiated actions.
        - `emailAddress` string — Email address. Present for email-initiated actions.
        - `createdAt` string, date-time, required — The date and time the action was created.
  - `error` string, nullable — Error message if the retrieval failed

---

[API](https://skmtc.dev/bem-team/apis/bem-api.md) · [All operations](https://skmtc.dev/bem-team/apis/bem-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bem-team/bem-api/revisions/a6e4624117c6/schema)