Skip to main content
POST
/
api
/
v1
/
experiments
/
costestimate
Estimate experiment cost
curl --request POST \
  --url https://foundry-api-public.adaptyvbio.com/api/v1/experiments/costestimate \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "experiment_spec": {
    "experiment_type": "affinity",
    "antigen_concentrations": [
      1000,
      316.2,
      100,
      31.6,
      0
    ],
    "method": "bli",
    "n_replicates": 3,
    "parameters": "<unknown>",
    "sequences": {},
    "target_id": "c383cc1d-fe22-5dbf-953c-378bc073019d"
  }
}
'
{
  "breakdown": {
    "assay": {
      "experiment_type": "screening",
      "n_replicates": 3,
      "replicate_price_cents": 2900,
      "sequence_count": 5,
      "subtotal_cents": 103500,
      "unit_price_cents": 14900
    },
    "pricing_version": "<string>",
    "total_cents": 106000,
    "materials": {
      "sequence_count": 5,
      "subtotal_cents": 2500,
      "target_id": "PD1-H5229",
      "target_name": "Human PD-L1",
      "unit_price_cents": 500
    }
  },
  "incomplete": {
    "assay": {
      "experiment_type": "screening",
      "n_replicates": 3,
      "replicate_price_cents": 2900,
      "sequence_count": 5,
      "subtotal_cents": 103500,
      "unit_price_cents": 14900
    },
    "materials_unavailable": {
      "reason": "Human PD-L1 is not yet onboarded to self-service pricing. You'll receive a quote with full price information.",
      "target_id": "c383cc1d-fe22-5dbf-953c-378bc073019d",
      "target_name": "Human PD-L1"
    },
    "pricing_version": "<string>",
    "total_cents": "<unknown>"
  },
  "warnings": [
    "<string>"
  ]
}

Authorizations

Authorization
string
header
required

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

Body

application/json

Request payload for cost estimation.

Contains the same experiment specification fields as creation, but does not require a name or project association.

Example

{
"experiment_spec": {
"experiment_type": "screening",
"target_id": "c383cc1d-fe22-5dbf-953c-378bc073019d",
"sequences": {
"seq1": "EVQLVESGGGLVQPGGSLRLSCAASGFTFS...",
"seq2": "MKTLVLLALLVGAALA..."
},
"n_replicates": 3
}
}
experiment_spec
object
required

Experiment specification for cost calculation (see ExperimentSpec for field details)

Response

Cost estimate calculated

Response wrapper for cost estimation endpoint.

Contains either a complete breakdown (when all pricing is available) or an incomplete estimate (when target lacks self-service pricing).

breakdown
object

Detailed cost breakdown. Present when pricing is fully available.

incomplete
object

Partial estimate. Present when target lacks self-service pricing.

warnings
string[]

Warnings about the estimate (e.g., unknown target, pricing limitations)