Overview
The AssayAgent API provides programmatic access to AI-optimized laboratory assay protocols, quality control parameters, and predictive analytics for assay optimization. This RESTful API is designed to integrate with Laboratory Information Management Systems (LIMS), Electronic Lab Notebooks (ELN), and automation platforms.
Key Features
- ๐งฌ 500+ Assay Protocols - ELISA, qPCR, Western Blot, Flow Cytometry, NGS, and more
- ๐ค AI Optimization - Machine learning models trained on millions of assay runs
- ๐ Predictive QC - Identify potential failures before they occur
- ๐ Real-time Updates - Continuously improving protocols based on global data
- ๐ Universal Integration - RESTful design works with any modern platform
- ๐ Analytics Dashboard - Track performance metrics and optimization opportunities
Authentication
The AssayAgent API uses API keys for authentication. Include your API key in the request header:
Authorization: Bearer YOUR_API_KEY Content-Type: application/json
To obtain an API key for the demo environment, use the test key:
demo_key_2025_assayagent
Base URL
All API requests should be made to:
https://api.assayagent.com/v1
https://assayagent.com/api
Get Assay Protocol
Retrieve detailed protocol information for a specific assay.
/assays/{assay_id}.json
200 OK
Parameters
Parameter | Type | Required | Description |
---|---|---|---|
assay_id | string | Required | Assay identifier in format: ASSAY_TARGET (e.g., ELISA_IL6) |
optimize | boolean | Optional | Include AI optimization suggestions (default: false) |
qc_level | string | Optional | QC stringency: basic | standard | strict (default: standard) |
Example Request
curl -X GET "https://assayagent.com/api/assays/ELISA_IL6.json" \ -H "Authorization: Bearer demo_key_2025_assayagent"
Example Response
{ "assay_id": "ELISA_IL6", "name": "Human IL-6 ELISA", "category": "Immunoassay", "version": "2.1.4", "ai_optimized": true, "confidence_score": 0.94, "protocol": { "duration_minutes": 240, "temperature_celsius": 25, "steps": [ { "step": 1, "name": "Plate Coating", "duration_minutes": 120, "temperature": 4, "reagents": [ { "name": "Capture Antibody", "concentration": "2 ยตg/mL", "volume_ul": 100 } ], "ai_tips": [ "Ensure uniform coating by gentle tapping", "Overnight coating at 4ยฐC improves sensitivity by 15%" ] } ] }, "qc_parameters": { "cv_threshold": 0.15, "r_squared_minimum": 0.98, "blank_od_maximum": 0.1, "positive_control_range": { "min": 1.5, "max": 2.5 } }, "optimization_insights": { "success_rate": "94% (based on 12,847 runs)", "common_failures": [ "High background: Check wash buffer preparation", "Poor standard curve: Verify dilution accuracy" ], "recommended_improvements": [ { "modification": "Increase wash cycles to 5x", "expected_improvement": "12% reduction in CV" } ] } }
List Available Assays
Get a list of all available assay protocols in the system.
/assays
200 OK
Query Parameters
Parameter | Type | Description |
---|---|---|
category | string | Filter by category (ELISA, qPCR, WesternBlot, etc.) |
target | string | Filter by target molecule |
limit | integer | Number of results (default: 20, max: 100) |
offset | integer | Pagination offset (default: 0) |
Error Handling
The API uses standard HTTP status codes and returns detailed error messages:
Status Code | Description | Common Causes |
---|---|---|
200 | Success | Request completed successfully |
400 | Bad Request | Invalid parameters or malformed request |
401 | Unauthorized | Missing or invalid API key |
404 | Not Found | Assay ID does not exist |
429 | Too Many Requests | Rate limit exceeded |
500 | Internal Server Error | Server-side issue (rare) |
Error Response Format
{ "error": { "code": "ASSAY_NOT_FOUND", "message": "The requested assay protocol was not found", "details": "Assay ID 'INVALID_ID' does not exist in the database", "timestamp": "2025-08-26T10:30:00Z" } }
Support & Domain Acquisition
This API documentation demonstrates the potential capabilities of an AI-powered laboratory automation platform. AssayAgent.com and all associated intellectual property are available for acquisition.
Ideal for:
- LIMS/ELN software companies expanding into AI
- Laboratory instrument manufacturers developing software platforms
- Biotech startups building next-generation lab automation
- Clinical diagnostic companies modernizing their infrastructure