ADadaptyvbio
targets

List targets

Lists validated antigens available for experiments. Each entry includes vendor and catalog identifiers, plus pricing where self-service pricing is available.

Pricing: Targets with pricing support instant cost estimation via /experiments/cost-estimate. Targets without this field require a custom quote — contact support for pricing on these targets.

Use selfservice_only=true to filter to only targets with pricing configured. Search by product name with search (case-insensitive substring). Filter and sort by name, vendor_name, catalog_number, or purity via the filter and sort parameters (e.g. ?filter=gte(purity,90)&sort=-name). Paginate with limit (default 50, max 100) and offset (default 0); the response includes total for computing remaining pages. Pass the returned id as experiment_spec.target_id when creating experiments.

get/api/v1/targets

Request

  • Base URL
    https://devs.adaptyvbio.com
  • URL
    https://devs.adaptyvbio.com/api/v1/targets
  • Auth
    HTTP bearer

Query parameters

limitinteger

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

offsetinteger

Number of items to skip (default 0).

searchstring

Free-text search term applied to searchable columns.

filterstring

Filter expression in s-expression syntax.

Comparison: eq(field,value), neq(field,value), gt(field,value), lt(field,value), gte(field,value), lte(field,value), contains(field,substring)

Range/set: between(field,lo,hi), in(field,v1,v2,...)

Logical: and(expr1,expr2,...), or(expr1,expr2,...), not(expr)

Null checks: is_null(field), is_not_null(field)

JSONB access: at(field,key) — e.g. eq(at(metadata,score),42)

Cast functions: float(expr), int(expr), text(expr), timestamp(expr), date(expr)

Example: and(gte(created_at,2026-01-01),eq(status,draft))

sortstring

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

Three accepted surface forms produce the same ordering:

  • Canonical — desc(field) / asc(field); also wraps casts and at(...) JSONB path access. Example: asc(date(at(metadata,start_date))).
  • Prefix short form — -field (descending), +field or bare field (ascending). GitHub / Stripe / Jira convention. Bare field only; no casts.
  • Suffix short form — field:asc / field:desc. Also bare field.

Examples: -created_at, -created_at,+name, created_at:desc, desc(created_at),asc(name), asc(at(metadata,score)).

selfservice_onlyboolean

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

show_conjugatedboolean

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

detailedboolean

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

countinteger required

Number of items in this response.

offsetinteger required

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

totalinteger required

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

Example response

{
  "items": [
    {
      "details": {
        "expression_system": "HEK293",
        "family": "Immunoglobulin superfamily",
        "gene_names": [
          "PDCD1",
          "PD1"
        ],
        "molecular_weight": "23.1 kDa",
        "ncbi_id": "NP_005009",
        "organism": "Human",
        "purity": 95,
        "sequence_length": 288,
        "structures": [
          {
            "id": "5JDR",
            "url": "https://files.rcsb.org/download/5JDR.pdb"
          }
        ],
        "subcellular_locations": [
          "Cell membrane"
        ],
        "tags": [
          "His"
        ]
      },
      "pricing": {
        "price_per_sequence_cents": 500
      },
      "uniprot_id": "Q15116",
      "url": "https://targets.adaptyvbio.com/protein/f3b2afd0-f70b-5191-a90a-ae1e0545c744"
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.