Skip to main content
GET
/
v1
/
therapeutic-candidates
/
{candidate_id}
Fetch a therapeutic candidate
curl --request GET \
  --url https://api.example.com/v1/therapeutic-candidates/{candidate_id} \
  --header 'Authorization: Bearer <token>'
{
  "antigen_ids": [
    "a1b2c3d4-e5f6-7890-abcd-ef1234567890"
  ],
  "created_at": "2026-04-23T14:15:00+00:00",
  "drug_class": "naked_antibody",
  "format": "mab",
  "format_metadata": {},
  "id": "c0f5e4b1-a7d2-4e0b-9f8c-1b2d3e4f5a6b",
  "initial_variant_id": "9999eeee-8888-dddd-7777-cccc66665555",
  "name": "anti-HER2 mab",
  "object": "therapeutic_candidate",
  "project_id": "7b4a3c0f-2e6d-4c7a-9e8f-1d3b5a2c4e6f",
  "source_antibody_ids": [
    "1111aaaa-2222-3333-4444-5555bbbbcccc"
  ],
  "updated_at": "2026-04-23T14:15:00+00:00"
}

Authorizations

​
Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

​
candidate_id
string<uuid>
required

Response

Successful Response

A therapeutic candidate as returned by /v1.

Carries the junction-table IDs (source antibodies, antigens) and the initial_variant_id surfaced by create_candidate so a caller can submit pipelines against it without a second round-trip.

​
id
string
required

Opaque therapeutic-candidate identifier (UUID).

Example:

"c0f5e4b1-a7d2-4e0b-9f8c-1b2d3e4f5a6b"

​
project_id
string
required

Project this candidate belongs to.

Example:

"7b4a3c0f-2e6d-4c7a-9e8f-1d3b5a2c4e6f"

​
name
string
required

Short human label shown in dashboards and logs.

​
format
enum<string>
required

Molecular format. Single-arm (mab, nanobody, scfv, fc_fusion) require one H+L pair or a single-chain spec. Multi-arm formats require all arms' chain specs at create time.

Available options:
mab,
nanobody,
scfv,
fc_fusion,
bispecific_kih,
bispecific_crossmab,
bispecific_common_lc,
bite,
dart,
dvd_ig,
tandem_scfv,
trispecific_tandem_scfv,
trispecific_igg_scfv,
trispecific_knh_scfv
​
drug_class
enum<string>
required

Therapeutic modality. naked_antibody is the default; adc and radioconjugate require a subsequent ADC-design record before payload synthesis.

Available options:
naked_antibody,
adc,
car,
radioconjugate,
t_cell_engager
​
created_at
string
required

ISO-8601 timestamp (UTC) when the candidate was registered.

​
updated_at
string
required

ISO-8601 timestamp (UTC) of the most recent mutation.

​
object
string
default:therapeutic_candidate

Polymorphic discriminator. Always therapeutic_candidate.

Allowed value: "therapeutic_candidate"
​
format_metadata
Format Metadata · object

Free-form metadata bag — the bispecific formats use this for arm assignments; other formats leave it empty.

​
description
string | null

Optional freeform note shown alongside the candidate.

​
source_antibody_ids
string[]

Source (parental) antibodies linked to this candidate. Maintained via the /v1/therapeutic-candidates/{id}/source-antibodies/{sa_id} endpoints.

​
antigen_ids
string[]

Antigens this candidate targets. Maintained via the /v1/therapeutic-candidates/{id}/antigens/{antigen_id} endpoints.

​
initial_variant_id
string | null

The baseline variant (v1) auto-created alongside this candidate. Populated on create responses; null on read responses — to walk variants post-creation, list them via the variants resource (not yet exposed in /v1, Phase 3 follow-up).