Skip to main content
GET
/
api
/
v1
/
targets
List targets
curl --request GET \
  --url https://foundry-api-public.adaptyvbio.com/api/v1/targets \
  --header 'Authorization: Bearer <token>'
{
  "count": 123,
  "items": [
    {
      "catalog_number": "<string>",
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "name": "<string>",
      "url": "https://targets.adaptyvbio.com/protein/f3b2afd0-f70b-5191-a90a-ae1e0545c744",
      "vendor_name": "<string>",
      "details": {
        "bioactivity": {
          "bli": true,
          "elisa": true,
          "spr": true
        },
        "description": "<string>",
        "expression_system": "HEK293",
        "family": "Immunoglobulin superfamily",
        "gene_names": [
          "PDCD1",
          "PD1"
        ],
        "molecular_weight": "23.1 kDa",
        "ncbi_id": "NP_005009",
        "organism": "Human",
        "purity": 95,
        "sequence": "<string>",
        "sequence_length": 288,
        "structures": [
          {
            "id": "5JDR",
            "url": "https://files.rcsb.org/download/5JDR.pdb"
          }
        ],
        "subcellular_locations": [
          "Cell membrane"
        ],
        "synonyms": [
          "<string>"
        ],
        "tags": [
          "His"
        ]
      },
      "pricing": {
        "price_per_sequence_cents": 500,
        "type": "per_sequence"
      },
      "uniprot_id": "Q15116"
    }
  ],
  "offset": 123,
  "total": 123
}

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.

Query Parameters

​
limit
integer<int64>

Maximum number of items to return (1-100, default 50).

​
offset
integer<int64>

Number of items to skip (default 0).

​
search
string

Free-text search term applied to searchable columns.

​
sort
string

Sort expression. Supports multi-column sort (comma-separated, up to 8), JSONB path access, and type casts.

Examples: desc(created_at), desc(created_at),asc(name), asc(at(metadata,score)), asc(date(at(metadata,start_date)))

​
selfservice_only
boolean

When true, returns only targets with self-service pricing configured. Targets without pricing require a custom quote flow.

​
show_conjugated
boolean

When true, includes conjugated targets (biotinylated, fluorophore-labeled, etc.) in results. By default, only unconjugated targets are returned.

​
detailed
boolean

When true, populates the details block on each target with enrichment data (gene names, structures, sequence, bioactivity, etc.). Defaults to false for lightweight listing.

Response

Target list

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

Number of items in this response.

​
items
object[]
required

The page of results.

​
offset
integer<int64>
required

Offset used for this page (mirrors the offset query parameter).

​
total
integer<int64>
required

Total number of items matching the query (across all pages).