---
title: "List experiment updates"
method: GET
path: "/api/v1/experiments/{experiment_id}/updates"
tags: ["experiments"]
---

# List experiment updates

`GET /api/v1/experiments/{experiment_id}/updates`

## Request

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

Returns updates for one experiment, oldest first (chronological).
Update types include `status_change`, `progress`, and `error`.
Filter by type using `filter=eq(type,status_change)`.

## Path parameters

- `experiment_id` string, uuid, required

## Query parameters

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

## Response `200`

Experiment update 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.
    - `experiment_code` string, required: Experiment code for grouping and display
    - `experiment_id` string, uuid, required: ID of the experiment that generated this update
    - `id` string, required: Unique identifier for this update event (UUID)
    - `name` string, required: Name/title of the update
    - `timestamp` string, date-time, required: ISO 8601 timestamp when the update occurred
  - `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`: Unknown or inaccessible experiment
- `401`: Invalid or missing authentication token
- `403`: Insufficient permissions
- `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)