ADadaptyvbio
experiments

List results for an experiment

Returns all analysis results associated with a specific experiment. Results appear when the experiment's results_status field reaches Partial or All. Supports pagination via limit and offset query parameters.

Use this endpoint when you need results for a single experiment without filtering the global /results list. The response includes the same ResultInfo structure as the global endpoint, scoped to the specified experiment.

get/api/v1/experiments/{experiment_id}/results

Request

  • Base URL
    https://devs.adaptyvbio.com
  • URL
    https://devs.adaptyvbio.com/api/v1/experiments/{experiment_id}/results
  • Auth
    HTTP bearer

Path parameters

experiment_idstring uuid required

Experiment identifier (UUID)

Query parameters

limitinteger

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

offsetinteger

Number of items to skip (default 0).

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))

searchstring

Free-text search term applied to searchable columns.

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)).

Response

Results for the experiment

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": [
    {
      "summary": [
        {
          "binding_model": [
            "standard"
          ],
          "fit_quality": "good",
          "performance": {
            "Positive Control": "better"
          },
          "replicates": [
            {
              "fit_quality": "good",
              "rmse_max_signal_pct": 1.2
            }
          ],
          "rmse_max_signal_pct": 1.2,
          "sequence": {
            "aa_string": "EVQLVESGGGLVQPGGSLRLSCAAS",
            "name": "mAb1"
          },
          "target": {
            "name": "Human PD-L1",
            "target_catalog_id": "019a03da-b87f-7e15-8b02-cef171c9871d"
          }
        }
      ]
    }
  ]
}

Changes

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