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

# List sequences

`GET /api/v1/sequences`

## Request

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

Returns sequences from all experiments the caller has access to. Results
are sorted by creation date (newest first). Filter by `experiment_id` to
retrieve sequences for a specific experiment, or use `search` to match
against sequence names or amino acid content.

## Query parameters

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

## Response `200`

Sequence 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.
    - `aa_preview` string, nullable: Truncated sequence preview (first 50 characters). Deprecated: read `aa_string` instead.
    - `aa_string` string, nullable: Full amino acid sequence. Present only when the caller also holds `sequence:read`.
    - `created_at` string, date-time, required: When the sequence was created (experiment submission time)
    - `experiment_code` string, required: Human-readable experiment code
    - `experiment_id` string, uuid, required: ID of the experiment containing this sequence
    - `id` string, uuid, required: Unique identifier for the sequence
    - `is_control` boolean, required: Whether this sequence is marked as a control
    - `length` integer, required: Full sequence length in amino acids
    - `name` string, nullable: Optional name assigned to the sequence
  - `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 to view sequences
- `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)