---
title: "List runs"
method: GET
path: "/assay-runs"
tags: ["assayRuns"]
---

# List runs

`GET /assay-runs`

## Request

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

List runs

## Query parameters

- `schemaId` string, required
- `minCreatedTime` integer
- `maxCreatedTime` integer
- `nextToken` string
- `pageSize` integer
- `ids` string, uuid

## Response `200`

OK

- AssayRunsPaginatedList
  - `assayRuns` AssayRun[]
    - `apiURL` string, uri: The canonical url of the Run in the API.
    - `archiveRecord` ArchiveRecord
      - `reason` string
    - `createdAt` string
    - `creator` UserSummary
      - `handle` string
      - `id` string
      - `name` string
    - `entryId` string, nullable
    - `equipmentId` string, nullable
    - `fields` Fields
    - `id` string
    - `isReviewed` boolean
    - `projectId` string, nullable
    - `schema` SchemaSummary
      - `id` string
      - `name` string
    - `v3Id` string: V3 identifier for the run
    - `validationComment` string, nullable
    - `validationStatus` 'VALID' | 'INVALID': Must be either VALID or INVALID
  - `nextToken` string

---

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