# Adaptyv Bio Docs - [Introduction](https://docs.adaptyvbio.com/docs/getting-started/introduction.md): Adaptyv is a cloud lab that turns protein sequences into reliable experimental data—fast. - [Project Workflow](https://docs.adaptyvbio.com/docs/getting-started/project-workflow.md): End-to-end workflow from configuration to data delivery - [Expression](https://docs.adaptyvbio.com/docs/experiment-types/expression.md): Test and quantify expression for your designed proteins. - [Binding](https://docs.adaptyvbio.com/docs/experiment-types/binding.md): Measure whether and how strongly your proteins bind their targets - [Thermostability](https://docs.adaptyvbio.com/docs/experiment-types/thermostability.md): Measure thermal stability (Tm) to de-risk development and formulations - [Enzyme Activity](https://docs.adaptyvbio.com/docs/experiment-types/enzyme-activity.md): Quantify catalytic performance with simple, comparable readouts - [Creating Experiments](https://docs.adaptyvbio.com/docs/experiment-setup/creating-experiments.md): Learn how to create experiments - [Supported Protein Formats](https://docs.adaptyvbio.com/docs/experiment-setup/supported-protein-formats.md): We supports a wide range of protein types - [Target Proteins](https://docs.adaptyvbio.com/docs/experiment-setup/target-proteins.md): We can work with nearly any soluble protein target that is commercially available, or we can custom express proteins for you. Browse our target catalog for an overview of available targets. If you need a custom or proprietary target, we can help source and prepare the appropriate materials. - [Binding Data Package](https://docs.adaptyvbio.com/docs/experiment-setup/binding-data-package.md): What arrives in your downloadable binding data bundle and how to work with it. - [Cell-Free Protein Expression](https://docs.adaptyvbio.com/wiki/technologies/cell-free-protein-expression.md): High-throughput protein production using cell-free expression systems for rapid prototyping and functional studies - [Biolayer Interferometry (BLI)](https://docs.adaptyvbio.com/wiki/technologies/BLI.md): Label-free optical technique for real-time protein binding measurements - [Surface Plasmon Resonance (SPR)](https://docs.adaptyvbio.com/wiki/technologies/SPR.md): Label-free, real-time binding kinetics and affinity measurements - [nanoDSF](https://docs.adaptyvbio.com/wiki/technologies/nanodsf.md): Nano Differential Scanning Fluorimetry for protein thermostability assessment and melting temperature determination - [Affinity Tag Purification](https://docs.adaptyvbio.com/wiki/technologies/affinity-tag-purification.md): High-throughput protein purification using engineered affinity tags for rapid isolation and concentration - [Split GFP Quantification](https://docs.adaptyvbio.com/wiki/technologies/split-GFP.md): Split GFP system for direct quantification of protein expression and qualitative yield estimation - [Capillary Electrophoresis (CE)](https://docs.adaptyvbio.com/wiki/technologies/capillary-electrophoresis.md): Capillary electrophoresis for quantitative analysis of protein expression, purity, and heterogeneity - [Quant-iT Protein Assay (Qubit)](https://docs.adaptyvbio.com/wiki/technologies/quant-it.md): Fluorescent dye–based protein quantification for sensitive expression measurements - [HPLC-SEC](https://docs.adaptyvbio.com/wiki/technologies/hplc-sec.md): High-Performance Liquid Chromatography Size-Exclusion Chromatography for protein aggregation detection and quality control - [IgG](https://docs.adaptyvbio.com/wiki/proteins/igg.md): Full-length antibody format with two antigen-binding sites - [Fab](https://docs.adaptyvbio.com/wiki/proteins/fab.md): Antibody fragment containing one antigen-binding site - [scFv](https://docs.adaptyvbio.com/wiki/proteins/scfv.md): Minimal antibody fragment with variable domains linked by a peptide - [VHH (Nanobodies)](https://docs.adaptyvbio.com/wiki/proteins/vhh.md): Single-domain antibody fragment derived from camelids - [Miniproteins](https://docs.adaptyvbio.com/wiki/proteins/miniproteins.md): De novo or engineered small proteins with stable, designed folds - [Peptides](https://docs.adaptyvbio.com/wiki/proteins/peptides.md): Short amino acid chains used as binders, modulators, and scaffolds - [Natural Ligands](https://docs.adaptyvbio.com/wiki/proteins/ligands.md): Endogenous peptides, proteins, or small molecules that bind biological targets - [Expression Systems](https://docs.adaptyvbio.com/wiki/proteins/protein-expression-systems.md): We provide binding targets expressed in various expression systems - [Protein Conjugates](https://docs.adaptyvbio.com/wiki/proteins/protein-conjugates.md): We provide binding targets expressed with various conjugates - [ESM](https://docs.adaptyvbio.com/wiki/models/esm.md): Evolutionary Scale Modeling: protein LMs for representation, structure, and design - [SolubleMPNN](https://docs.adaptyvbio.com/wiki/models/solublempnn.md): Sequence design with solubility-aware objectives - [ipTM](https://docs.adaptyvbio.com/wiki/models/iptm.md): Interface predicted TM-score from AlphaFold‑Multimer for complex/interface quality - [AlphaFold‑Multimer](https://docs.adaptyvbio.com/wiki/models/alphafold-multimer.md): Structure prediction for protein complexes with interface confidence metrics (e.g., ipTM) - [pSAE](https://docs.adaptyvbio.com/wiki/models/psae.md): Percent Solvent‑Accessible Exposed hydrophobicity (and related exposure metrics) - [Improve Protein Expression](https://docs.adaptyvbio.com/guides/improve-protein-expression.md): Practical strategies to get your proteins expressing better on our platform - [Coming Soon](https://docs.adaptyvbio.com/guides/protein-design-101/overview.md) - [Foundry API](https://docs.adaptyvbio.com/api-reference/api-introduction.md): Submit protein sequences for experimental characterization and retrieve results programmatically. - [MCP Server](https://docs.adaptyvbio.com/api-reference/mcp-server.md): Drive Adaptyv experiments through Claude Code, Claude Desktop, or any MCP-aware client using natural language. - [Integrator & Partner Guide](https://docs.adaptyvbio.com/api-reference/integrator-partner-guide.md): How to integrate the Foundry API into your platform with a BYOK flow, and when to apply to the Partner Program. - [Payments Overview](https://docs.adaptyvbio.com/api-reference/payments/overview.md): How an order gets paid: confirm the quote to issue an invoice, then settle it through the hosted invoice page, x402, or a Stripe Shared Payment Token. - [Pay by hosted invoice](https://docs.adaptyvbio.com/api-reference/payments/pay-hosted-invoice.md): The default flow: create an experiment, confirm the quote, and pay the Stripe-hosted invoice in a browser. - [Pay with x402 (exact)](https://docs.adaptyvbio.com/api-reference/payments/pay-x402-exact.md): Sign an EIP-3009 transferWithAuthorization, send it in the PAYMENT-SIGNATURE header, and let the facilitator verify and settle the USDC transfer on-chain. - [Pay with a Shared Payment Token (MPP-SPT)](https://docs.adaptyvbio.com/api-reference/payments/pay-mpp-spt.md): Read the challenge, mint a bounded Stripe Shared Payment Token, and settle the invoice as a single card charge. - [List experiments](https://docs.adaptyvbio.com/api-reference/experiments/list-experiments.md): Lists experiments accessible to the caller, sorted by creation date (newest first). Experiments progress from submission through review, production, and analysis until results are available. - [Create experiment](https://docs.adaptyvbio.com/api-reference/experiments/create-experiment.md): Creates a new experiment request for the Adaptyv Foundry platform. - [Estimate experiment cost](https://docs.adaptyvbio.com/api-reference/experiments/estimate-experiment-cost.md): Calculates the estimated cost for an experiment without creating it. Useful for previewing costs before submission. - [Get experiment](https://docs.adaptyvbio.com/api-reference/experiments/get-experiment.md): Returns full metadata for an experiment: workflow status, target and sequence details, assay parameters, and billing references. - [Update experiment](https://docs.adaptyvbio.com/api-reference/experiments/update-experiment.md): Modify an existing experiment's configuration or status. - [Get experiment invoice](https://docs.adaptyvbio.com/api-reference/experiments/get-experiment-invoice.md): Returns invoice metadata for a confirmed experiment, including the hosted payment URL. Available once `stripe_invoice_url` appears in the experiment detail; timing depends on organization billing settings. - [Get experiment quote](https://docs.adaptyvbio.com/api-reference/experiments/get-experiment-quote.md): Returns quote metadata: totals, currency, status, and expiration. The `expires_at` field shows when the quote expires if not confirmed. - [Accept an experiment's quote and create an invoice](https://docs.adaptyvbio.com/api-reference/experiments/accept-an-experiments-quote-and-create-an-invoice.md): A JSON body is required. Every field of `ConfirmQuoteRequest` is optional, so a caller with no purchase-order number and no notes sends `{}` — the refusal says so if they forget (BUG-0059). - [Get experiment quote PDF](https://docs.adaptyvbio.com/api-reference/experiments/get-experiment-quote-pdf.md): Returns the quote as a PDF containing itemized pricing, terms, and experiment configuration. Response content-type is `application/pdf`. - [List results for an experiment](https://docs.adaptyvbio.com/api-reference/experiments/list-results-for-an-experiment.md): 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. - [List sequences for an experiment](https://docs.adaptyvbio.com/api-reference/experiments/list-sequences-for-an-experiment.md): Returns all sequences associated with a specific experiment. Results are sorted by creation date (newest first) and can be searched by name or amino acid content. Supports pagination via `limit` and `offset` query parameters. - [Submit experiment](https://docs.adaptyvbio.com/api-reference/experiments/submit-experiment.md): Submits a draft experiment for review. Advances from Draft to WaitingForConfirmation by finalizing the Stripe quote. To accept an already-submitted quote, use `POST /experiments/{id}/quote/confirm`. - [List experiment updates](https://docs.adaptyvbio.com/api-reference/experiments/list-experiment-updates.md): Returns updates for one experiment, oldest first (chronological). Update types include `status_change`, `progress`, and `error`. Filter by type using `filter=eq(type,status_change)`. - [Submit feedback, bug reports, or feature requests](https://docs.adaptyvbio.com/api-reference/feedback/submit-feedback-bug-reports-or-feature-requests.md): Use this endpoint to give us feedback, report bugs that are not already caught by our observability, or request features (or have your agents do it). - [Liveness probe](https://docs.adaptyvbio.com/api-reference/info/liveness-probe.md): Returns 200 when the service is alive. No authentication required. No database interaction. - [Database connectivity probe](https://docs.adaptyvbio.com/api-reference/info/database-connectivity-probe.md): Verifies database connectivity by executing a trivial query. Returns 200 when the database is reachable, 503 when it is not. - [List invoices](https://docs.adaptyvbio.com/api-reference/invoices/list-invoices.md): Lists every invoice generated for the caller's organization so clients can display billing history, monitor outstanding balances, and reconcile payments. Results are sorted by creation date by default and include due dates, currency, and current status for each invoice. - [Get invoice](https://docs.adaptyvbio.com/api-reference/invoices/get-invoice.md): Fetches a single invoice by its Foundry UUID or Stripe invoice ID (`in_xxx`). The caller's org membership scopes visibility — an invoice belonging to an org the caller cannot access returns 404. - [Pay invoice](https://docs.adaptyvbio.com/api-reference/invoices/pay-invoice.md): Settles the given invoice. How it settles is chosen by the `X-Adaptyv-Payment-Method` request header: - [Get invoice PDF](https://docs.adaptyvbio.com/api-reference/invoices/get-invoice-pdf.md): Redirects (307) to the Stripe-hosted PDF for the given invoice. The PDF is only available after the invoice has been finalized (status `open` or `paid`). Requesting a PDF for a `draft` invoice returns 404 — finalize the invoice first by submitting and confirming the associated quote. - [List quotes](https://docs.adaptyvbio.com/api-reference/quotes/list-quotes.md): Returns every quote recorded for the caller's organization. Use this list to monitor pending proposals, track which quotes have already been accepted or expired, and review pricing history before moving to the detail or acceptance endpoints. - [Get quote](https://docs.adaptyvbio.com/api-reference/quotes/get-quote.md): Returns the full quote document with itemized pricing, totals, expiration, and status, combined with experiment metadata (org name, notes). - [Accept quote](https://docs.adaptyvbio.com/api-reference/quotes/accept-quote.md): Finalizes and accepts a Stripe quote, creating the (open, unpaid) invoice and advancing the linked experiment to `WaitingForMaterials`. Optionally attach a purchase order number for your records. - [Reject quote](https://docs.adaptyvbio.com/api-reference/quotes/reject-quote.md): Cancels the quote on Stripe and records the rejection reason and optional feedback in the database. The linked experiment reverts to `Draft` so it can be modified and re-submitted. - [List results](https://docs.adaptyvbio.com/api-reference/results/list-results.md): Lists completed analysis results, sorted by creation date (newest first). Results appear when an experiment's `results_status` field reaches `Partial` or `All`. Paginate with `limit` (default 50) and `offset`; the response includes `total` for page calculation. - [Get result](https://docs.adaptyvbio.com/api-reference/results/get-result.md): Returns a single result with its full `summary`: mean kinetics and the per-replicate measurements for an affinity result, or the per-sample melting readouts for a thermostability result. The `data_package_url` field links to the raw data package, the same one available in the Foundry portal. - [List sequences](https://docs.adaptyvbio.com/api-reference/sequences/list-sequences.md): Returns sequences from all experiments the caller has access to. Results are sorted by creation date (newest first). Filter by `experiment_id` to retrieve sequences for a specific experiment, or use `search` to match against sequence names or amino acid content. - [Add sequences to experiment](https://docs.adaptyvbio.com/api-reference/sequences/add-sequences-to-experiment.md): Appends sequences to a draft experiment identified by its human-readable code (e.g., "PROJ-001"). The experiment must be in Draft status; confirmed or later-stage experiments cannot accept new sequences. Create a new experiment to submit additional sequences if the original has progressed past draft… - [Get sequence](https://docs.adaptyvbio.com/api-reference/sequences/get-sequence.md): Returns full details for a specific sequence including the complete amino acid string, metadata, and a reference to the containing experiment. - [List targets](https://docs.adaptyvbio.com/api-reference/targets/list-targets.md): Lists validated antigens available for experiments. Each entry includes vendor and catalog identifiers, plus `pricing` where self-service pricing is available. - [List custom target requests](https://docs.adaptyvbio.com/api-reference/targets/list-custom-target-requests.md): Returns custom target requests for your organization, sorted by creation date (newest first). Supports filtering by status using the `filter` parameter (e.g. `filter=eq(status,pending_review)`) and pagination. - [Submit custom target request](https://docs.adaptyvbio.com/api-reference/targets/submit-custom-target-request.md): Submit a new custom target (antigen) for staff review. At least one of `sequence` or `pdb_id` must be provided. The `product_id` must be unique within your organization. - [Get custom target request](https://docs.adaptyvbio.com/api-reference/targets/get-custom-target-request.md): Retrieves full details of a custom target request, including sequence data, PDB information, and metadata. Returns 404 if the request doesn't exist or belongs to a different organization. - [Get target](https://docs.adaptyvbio.com/api-reference/targets/get-target.md): Returns the catalog record for a single target by UUID. - [List tokens](https://docs.adaptyvbio.com/api-reference/tokens/list-tokens.md): Returns a flat, paginated list of all tokens (root and attenuated) the caller owns. Each item carries lineage fields (`parent_token_id`, `root_token_id`, `kind`) so callers can reconstruct the derivation tree. Admins with global scope see all tokens across all users. - [Attenuate token](https://docs.adaptyvbio.com/api-reference/tokens/attenuate-token.md): Add restrictions to an existing token without needing the private key. - [Revoke the calling token and its entire lineage](https://docs.adaptyvbio.com/api-reference/tokens/revoke-the-calling-token-and-its-entire-lineage.md): Revokes the root token used to authenticate this request and all of its attenuated descendants, making the entire token family invalid for future API calls. - [List updates](https://docs.adaptyvbio.com/api-reference/updates/list-updates.md): Returns the experiment update feed, newest first: status changes, progress markers, and completion events. Use `limit` and `offset` query parameters for pagination. Filter by experiment or type using the `filter` parameter, e.g. `filter=eq(experiment_id,)` or `filter=in(experiment_id,uuid1,uui… - [List the organization's webhook registrations.](https://docs.adaptyvbio.com/api-reference/webhooks/list-the-organizations-webhook-registrations.md) - [Register a webhook for the organization.](https://docs.adaptyvbio.com/api-reference/webhooks/register-a-webhook-for-the-organization.md) - [Remove a webhook registration.](https://docs.adaptyvbio.com/api-reference/webhooks/remove-a-webhook-registration.md) - [Modify a webhook registration, including rotating or clearing its secret.](https://docs.adaptyvbio.com/api-reference/webhooks/modify-a-webhook-registration-including-rotating-or-clearing-its-secret.md) - [Who am I](https://docs.adaptyvbio.com/api-reference/whoami/who-am-i.md): Identify yourself from your API token. Returns the organizations your token can access — with the organization you are currently acting as marked `active: true` — along with your user id, the permissions your token grants, and when the token expires. - [Changelog](https://docs.adaptyvbio.com/changelog/changelog.md): Track updates and changes to Adaptyv Bio's documentation and services ## OpenAPI Specs - [openapi](https://devs.adaptyvbio.com/api/v1/openapi.json) ## Optional - [Careers](https://www.adaptyvbio.com/careers) - [Blog](https://www.adaptyvbio.com/blog) - [Experiment Configurator](https://start.adaptyvbio.com) - [Foundry Portal](https://foundry.adaptyvbio.com)