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

# List datasets

`GET /datasets`

## Request

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

List datasets

## Query parameters

- `pageSize` integer
- `nextToken` string
- `sort` 'modifiedAt' | 'name' | 'createdAt' | 'modifiedAt:asc' | 'name:asc' | 'createdAt:asc' | 'modifiedAt:desc' | 'name:desc' | 'createdAt:desc'
- `archiveReason` string
- `createdAt` string
- `creatorIds` string
- `folderId` string
- `mentionedIn` string
- `modifiedAt` string
- `name` string
- `nameIncludes` string
- `names.anyOf.caseSensitive` string
- `names.anyOf` string
- `originIds` string
- `ids` string
- `displayIds` string
- `returning` string

## Response `200`

OK

- DatasetsPaginatedList
  - `datasets` 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.
  - `nextToken` string

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