Skip to main content
GET
/
api
/
v1
/
sequences
/
{sequence_id}
Get sequence
curl --request GET \
  --url https://foundry-api-public.adaptyvbio.com/api/v1/sequences/{sequence_id} \
  --header 'Authorization: Bearer <token>'
{
  "created_at": "2023-11-07T05:31:56Z",
  "experiment": {
    "experiment_code": "<string>",
    "experiment_id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
    "experiment_status": "<string>"
  },
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "is_control": true,
  "length": 1,
  "aa_string": "<string>",
  "metadata": "<unknown>",
  "name": "<string>"
}

Authorizations

​
Authorization
string
header
required

Biscuit-based bearer token. Obtain tokens from the Adaptyv Portal or via the /tokens endpoint. Tokens encode organization membership and role-based capabilities; the API verifies the token's cryptographic signature and authorization claims before processing requests. Use /tokens/attenuate to create restricted tokens for delegation.

Path Parameters

​
sequence_id
string<uuid>
required

Unique identifier of the sequence

Response

Sequence details

Full details for a specific sequence.

Includes the complete amino acid sequence, metadata, and experiment reference.

​
created_at
string<date-time>
required

When the sequence was created

​
experiment
object
required

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<int32>
required

Sequence length in amino acids

Required range: x >= 0
​
aa_string
string | null

Complete amino acid sequence

​
metadata
any

Sequence-level annotations from the analysis pipeline.

When present, may include chain assignments and framework region boundaries for antibody sequences. Structure varies by experiment type.

​
name
string | null

Optional name assigned to the sequence