---
title: "List experiments"
method: GET
path: "/api/v1/experiments"
tags: ["experiments"]
---

# List experiments

`GET /api/v1/experiments`

## Request

- Base URL: `https://devs.adaptyvbio.com`
- URL: `https://devs.adaptyvbio.com/api/v1/experiments`
- Auth: HTTP bearer

Lists experiments accessible to the caller, sorted by creation date
(newest first). Experiments progress from submission through review,
production, and analysis until results are available.

The response includes only experiments within the caller's organization
scope. Filter by `status` for specific workflow stages, by `state` for
broader groupings, or by `search` for name/code substring matches.
Date operators (`lte`, `gte`, `lt`, `gt`, `eq`) accept ISO 8601 dates
or timestamps via `filter=` s-expression. Paginate with `limit` and
`offset`; fetch pages until fewer than `limit` items return.

## Query parameters

- `limit` integer
- `offset` integer
- `filter` string
- `search` string
- `sort` string

## Response `200`

Experiment list

- object: Paginated list response with offset-based navigation metadata. All list endpoints return this shape. Use `offset` and `limit` query parameters to page through results; `total` reports how many items match the query across all pages.
  - `count` integer, required: Number of items in this response.
  - `items` object[], required: The page of results.
    - `code` string, required: Unique experiment code (e.g., "EXP-2024-001")
    - `created_at` string, date-time, required: ISO 8601 timestamp of experiment creation
    - `experiment_type` 'affinity' | 'screening' | 'thermostability' | 'fluorescence' | 'expression' | 'epitope_binning' | 'enzyme_activity': Experiment type determining the assay workflow.
    - `experiment_url` string, required: URL to view the experiment in the Foundry portal
    - `id` string, uuid, required: Unique identifier for the experiment
    - `name` string, nullable: Human-readable name for the experiment (nullable in database)
    - `results_status` 'none' | 'partial' | 'all', required: Indicates the availability of results for an experiment.
    - `status` 'draft' | 'waiting_for_confirmation' | 'canceled' | 'waiting_for_materials' | 'in_production' | 'quote_sent' | 'in_queue' | 'data_analysis' | 'in_review' | 'done', required: Current lifecycle stage of an experiment. Status values indicate where an experiment is in the submission-to-results pipeline. Some transitions require user action (such as accepting a quote), while others occur automatically as work progresses.
    - `stripe_invoice_url` string, nullable: Invoice URL (not populated in list/detail responses; use the dedicated invoice endpoint).
    - `stripe_quote_url` string, nullable: Quote reference URL (may require provider account access).
  - `offset` integer, required: Offset used for this page (mirrors the `offset` query parameter).
  - `total` integer, required: Total number of items matching the query (across all pages).

## Other responses

- `400`: Invalid experiment_type filter value
- `401`: Invalid or missing authentication token
- `403`: Insufficient permissions to list experiments
- `500`: Internal server error

---

[API](https://skmtc.dev/adaptyvbio/apis/adaptyv-foundry-api.md) - [All operations](https://skmtc.dev/adaptyvbio/apis/adaptyv-foundry-api/llms.txt) - [OpenAPI document](https://skmtc.dev/adaptyvbio/apis/adaptyv-foundry-api/revisions/5a2228f4bd59?raw)