Skip to main content
Adaptyv Bio API
The Foundry API lets you submit protein sequences, track experiments, and check in on updates directly from your code. Instead of using the web portal, you can start to automate your entire campaign workflow.
The API is in early beta. Core endpoints are somewhat stable, but some may evolve and you should expect at least one more break as we refine the platform. To request access, email [email protected].

​
What You Can Do

The API exposes three main resources. Experiments let you submit sequences for testing, check their status, and retrieve configuration details. You create an experiment by specifying a target antigen and one or more protein sequences; the platform then queues your submission for laboratory processing. Updates become available once an experiment completes. The API will give you coarse grained updates (in particular informing your about which results being available as none,partial or all ) and you can then use the experiment link in the same /experiments/{id} response to check them out. Targets You can browse available all targets available at Adaptyv and search via a substring.

​
Authentication

Every request requires a bearer token in the Authorization header. Contact us to receive credentials for your organization.

​
Base URL

https://foundry-api-public.adaptyvbio.com/

​
Getting Started

First, email [email protected] to request beta access. We will respond with your API token and organization ID. From there, explore the endpoint documentation below and start integrating. Our team can help if you run into questions.

​
Example

This snippet submits a new experiment: 
import requests

response = requests.post(
    "https://foundry-api-public.adaptyvbio.com/experiments",
    headers={"Authorization": "Bearer YOUR_API_TOKEN"},
    json={
        "name": "Binding Screen Batch 1",
        "target_id": "${uuid-from /targets}",
        "sequences": [
            {"fasta": "MKTVRQERLKSIVRILERSKEPVSGAQ..."},
            {"fasta": "MGQIVTMFEALPHIIDRDLKQERLKSI..."}
        ],
        "webhook_url": "https://your-server.com/webhook"
    }
)

​
Notes

The API is in beta: core functionality works, but minor changes may occur. We review all access requests manually and prioritize support for beta users. For detailed endpoint documentation, see the API Endpoints section below.