# Ginkgo Cloud Lab — Full API Reference for AI Agents

> Base URL: https://lzjgtncigbsqoewxggvf.supabase.co/functions/v1/agent-api

## GET /services

Returns all available services with pricing, turnaround times, and input requirements.

### Response (JSON)
```json
{
  "services": [
    {
      "slug": "cell-free-protein-expression-validation",
      "name": "Cell Free Protein Expression Validation",
      "description": "Send us any sequence up to 1,800 bp and we'll tell you if it expresses in our cell-free protein synthesis lysate. For sequences longer than 1,800 bp, contact us.",
      "pricing": "$39 per sample",
      "base_price_usd": 39.00,
      "turnaround": "up to 10 days",
      "status": "available",
      "required_inputs": {
        "customer_email": "string (required)",
        "file": "CSV or XLSX with columns: Protein Name, Target Protein AA Sequence, Linker AA Sequence, Tag AA Sequence, Tag Position, Final DNA Sequence, Notes",
        "replicate_count": "integer (default: 3, options: 1-3)",
        "additional_details": "string (optional, free-text notes)"
      },
      "template_url": "https://cloud.ginkgo.bio/templates/Ginkgo_Cloud_Lab_Input_Template_CFPS.csv"
    }
  ]
}
```

## POST /orders

Submit an order programmatically. Returns a Shopify checkout URL for payment.

### Request Headers
```
Content-Type: application/json
```

### Request Body
```json
{
  "service_slug": "cell-free-protein-expression-validation",
  "customer_email": "researcher@university.edu",
  "protein_count": 4,
  "replicate_count": 3,
  "additional_details": "Please prioritize samples 1 and 2",
  "proteins": [
    {
      "name": "Test_Protein_1",
      "target_sequence": "MGNDG",
      "linker_sequence": "GGGS",
      "tag_sequence": "VSGWRLFKKIS",
      "tag_position": "C-terminal"
    }
  ]
}
```

### Response
```json
{
  "success": true,
  "checkout_url": "https://n1rrnm-i0.myshopify.com/checkout/...",
  "order_file_id": "uuid",
  "message": "Order created. Complete payment at the checkout URL."
}
```

## Service Details

### minibinder-strep-tag-a280
- Price: $149/sample
- Turnaround: up to 11 days
- Input: CSV/XLSX with minibinder protein sequences containing Strep-tag II
- Deliverables: Purified minibinder protein, A280 yield quantification (mg/mL)

### cfps-expression-purification-quantification
- Price: $159/sample
- Turnaround: up to 12 days
- Input: CSV/XLSX with protein sequences containing Strep-tag II
- Deliverables: Expression detection, Strep-tag purification, A280 yield quantification

### echo-ms-cfps-detection (Beta)
- Price: $44/sample
- Turnaround: up to 13 days
- Input: CSV/XLSX with protein sequences and target molecule details (sequences longer than 1,800 bp: contact us)
- Deliverables: Echo-MS detection of enzymatic reaction products in cell-free expression

### echo-ms-method-onboarding
- Price: $799/molecule
- Turnaround: up to 3 weeks
- Input: Target molecule details, reference standards
- Deliverables: Validated Echo-MS detection method for your molecule

### cell-free-protein-expression-validation
- Price: $39/sample
- Turnaround: up to 10 days
- Input: CSV/XLSX with protein sequences (up to 1,800 bp; contact us for longer)
- Deliverables: Expression detection (pass/fail), gel images

### cell-free-protein-expression-optimization
- Price: $199/sample
- Turnaround: up to 11 days
- Input: CSV/XLSX with protein sequences (up to 1,800 bp; contact us for longer)
- Deliverables: 24-condition expression screen, optimal condition recommendation

### cell-free-protein-expression-hibit
- Price: $39/sample
- Turnaround: up to 11 days
- Input: CSV/XLSX with HiBiT-tagged protein sequences
- Deliverables: Expression detection (bcRLU), yield (nM), Z-prime, CV%

### cfps-strep-tag-purification-a280
- Price: $149/sample
- Turnaround: up to 11 days
- Input: CSV/XLSX with Strep-tag II protein sequences
- Deliverables: Purified protein, A280 yield quantification

### cfps-strep-purification-thermal-shift
- Price: $159/sample
- Turnaround: up to 12 days
- Input: CSV/XLSX with Strep-tag II protein sequences
- Deliverables: Purified protein, A280 yield quantification, thermal shift assay results

### ecoli-protein-expression-hibit
- Price: $79/sample
- Turnaround: up to 3 weeks
- Input: CSV/XLSX with HiBiT-tagged protein sequences for E. coli expression
- Deliverables: Expression detection in E. coli (bcRLU), yield, Z-prime, CV%

### spr-target-onboarding
- Price: $1,399/target
- Turnaround: up to 4 weeks
- Input: Target details and reference standards
- Deliverables: Validated SPR assay for your target

### fluorescent-pixel-art-generation (Beta)
- Price: $25/plate
- Turnaround: up to 7 days
- Input: PNG/JPG image (pixel art, max 48x32 pixels)
- Deliverables: Fluorescent bacterial artwork on agar omni-tray, timelapse photos

## CSV Template Format

Download: https://cloud.ginkgo.bio/templates/Ginkgo_Cloud_Lab_Input_Template_CFPS.csv

Columns:
- Protein Name (required)
- Target Protein AA Sequence (required)
- Linker AA Sequence (optional)
- Tag AA Sequence (optional)
- Tag Position (optional: "N-terminal" or "C-terminal")
- Final DNA Sequence (optional)
- Notes (optional)

## Terms

Orders require payment via Shopify checkout. Services are subject to Ginkgo Cloud Lab terms of service at https://cloud.ginkgo.bio/terms.