---
title: "List datasets"
method: GET
path: "/v3/datasets"
tags: ["Function Accuracy"]
---

# List datasets

`GET /v3/datasets`

**List datasets** in the environment, newest first.

## Query parameters

- `datasetNameSearch` string
- `limit` integer
- `startingAfter` string
- `endingBefore` string

## Response `200`

The request has succeeded.

- GoldenDataSetListResponse — Response containing a list of golden data sets
  - `datasets` GoldenDataSetSummary[], nullable — List of datasets
    - `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.
  - `totalCount` integer, nullable — Total number of datasets
  - `error` string, nullable — Error message if the list operation 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)