The Adaptyv Bio API provides programmatic access to our cloud laboratory platform, enabling you to integrate protein testing workflows directly into your computational pipelines.

The Foundry API is currently in alpha. Features and endpoints may change significantly. To request API access, please email support@adaptyvbio.com.

​
Current Capabilities

Based on the OpenAPI specification, the alpha API currently supports:

​
Experiments

  • Create experiments - Submit new protein sequences for testing
  • List experiments - Track all your experiments and their status
  • Get experiment details - Monitor progress and access configuration

​
Results

  • List results - Browse completed experiment results
  • Download results - Access detailed data packages and analysis

​
Targets

  • Browse catalog - Search available antigen targets from ACROBiosystems
  • Get target details - View specifications and pricing
  • Request new targets - Submit requests for antigens not in the catalog

​
Organizations

  • View organization - Check credits and usage metrics
  • Monitor balance - Track credit consumption over time

​
Authentication

All API requests require a bearer token. Contact us to receive your API credentials during the alpha period.

​
Base URL

https://kq5jp7qj7wdqklhsxmovkzn4l40obksv.lambda-url.eu-central-1.on.aws/

​
Getting Started

  1. Request Access - Email support@adaptyvbio.com to join the alpha program
  2. Receive Credentials - We’ll provide your API token and organization ID
  3. Explore Endpoints - Use the API Endpoints section to explore available operations
  4. Integration Support - Our team will help you integrate the API into your workflows

​
Example Usage

# Submit a new experiment
import requests

headers = {
    "Authorization": "Bearer YOUR_API_TOKEN"
}

experiment = {
    "name": "Binding Screen Batch 1",
    "target_id": "acro:12345",
    "sequences": [
        {"fasta": "MKTVRQERLKSIVRILERSKEPVSGAQ..."},
        {"fasta": "MGQIVTMFEALPHIIDRDLKQERLKSI..."}
    ],
    "webhook_url": "https://your-server.com/webhook"
}

response = requests.post(
    "https://kq5jp7qj7wdqklhsxmovkzn4l40obksv.lambda-url.eu-central-1.on.aws/experiments",
    headers=headers,
    json=experiment
)

​
Important Notes

  • Alpha Limitations - Not all platform features are available via API yet
  • Breaking Changes - Expect frequent updates and changes during alpha
  • Manual Approval - All API access requests are manually reviewed
  • Support Priority - Alpha users receive priority support for integration

For detailed endpoint documentation, explore the API Endpoints section below.