Skip to main content
GET
/
api
/
v1
/
targets
/
{target_id}
Get target
curl --request GET \
  --url https://foundry-api-public.adaptyvbio.com/api/v1/targets/{target_id} \
  --header 'Authorization: Bearer <token>'
{
  "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"
}

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

​
target_id
string<uuid>
required

Unique identifier of the target to retrieve

Response

Target details retrieved

Target catalog entry. Used by both list and detail endpoints.

The list endpoint returns this with details omitted (or populated when ?detailed=true). The detail endpoint always populates details.

​
catalog_number
string
required

Vendor's catalog/SKU number

​
id
string<uuid>
required

Unique identifier for the target from the catalog

​
name
string
required

Product name of the target antigen

​
url
string
required

URL to view this target in the catalog web UI

Example:

"https://targets.adaptyvbio.com/protein/f3b2afd0-f70b-5191-a90a-ae1e0545c744"

​
vendor_name
string
required

Vendor/supplier name (e.g., "ACRO Biosystems")

​
details
object

Detailed target data. Populated on the detail endpoint and on the list endpoint when ?detailed=true is passed.

​
pricing
object

Material pricing for this target, if self-service pricing is available. When absent, this target requires a custom quote.

The type field discriminates the pricing model:

  • per_sequence: fixed cost per sequence
  • per_broken_lot: customer pays for the full vendor lot
​
uniprot_id
string | null

UniProt accession for the primary protein component. Present on ~82% of targets; viral/non-standard proteins lack this (they have details.ncbi_id instead).

Example:

"Q15116"