---
title: "Get a worklist by ID"
method: GET
path: "/worklists/{worklist_id}"
tags: ["worklists"]
---

# Get a worklist by ID

`GET /worklists/{worklist_id}`

## Request

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

Get a worklist by ID

## Path parameters

- `worklist_id` string, required

## Query parameters

- `returning` string

## Response `200`

Returns a single worklist. Items within the worklist are returned as summaries only.

- Worklist: A worklist and its items as summaries.
  - `apiURL` string, uri: The canonical url of the Worklist in the API.
  - `createdAt` string, date-time: Date and time the worklist was created
  - `creator` WorklistCreator: UserSummary of the user who created the worklist
    - `handle` string
    - `id` string
    - `name` string
  - `id` string: ID of the worklist
  - `modifiedAt` string, date-time: Date and time the worklist was last modified
  - `name` string: Name of the worklist
  - `type` 'batch' | 'bioentity' | 'container' | 'plate': The type of items a worklist contains.
  - `worklistItems` WorklistItemSummary[]
    - `id` string: ID of the item
    - `name` string: Name of the item

## Other responses

- `404`: Not found

---

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