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

# List updates

`GET /api/v1/updates`

## Request

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

Returns the experiment update feed, newest first: status changes,
progress markers, and completion events. Use `limit` and `offset`
query parameters for pagination. Filter by experiment or type using
the `filter` parameter, e.g. `filter=eq(experiment_id,<uuid>)` or
`filter=in(experiment_id,uuid1,uuid2)` or `filter=eq(type,status_change)`.

## Query parameters

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

## Response `200`

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

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