---
title: "Get a dataset"
method: GET
path: "/datasets/{dataset_id}"
tags: ["datasets"]
---

# Get a dataset

`GET /datasets/{dataset_id}`

## Request

- Base URL: `https://{tenant_name}.benchling.com/api/v2-beta`
- URL: `https://{tenant_name}.benchling.com/api/v2-beta/datasets/{dataset_id}`
- Auth: HTTP bearer

Get a dataset

## Path parameters

- `dataset_id` string, required

## Response `200`

OK

- Dataset
  - `archiveRecord` ArchiveRecord
    - `reason` string
  - `createdAt` string, date-time: Date and time the dataset was created
  - `creator` DatasetCreator: UserSummary of the user who created the dataset
    - `handle` string
    - `id` string
    - `name` string
  - `customFields` CustomFields
  - `dataFrameId` string: ID of the data frame to link to this dataset
  - `displayId` string: User-friendly ID of the dataset
  - `folderId` string: ID of the folder that contains the dataset
  - `id` string
  - `modifiedAt` string, date-time: Date and time the dataset was last modified
  - `name` string: The user-facing name for this Dataset.

## Other responses

- `400`: Bad Request

---

[API](https://skmtc.dev/benchling/apis/benchling-api-beta.md) - [All operations](https://skmtc.dev/benchling/apis/benchling-api-beta/llms.txt) - [OpenAPI document](https://skmtc.dev/benchling/apis/benchling-api-beta/revisions/eba0b3d5b98e?raw)