API Reference
The Omic REST API provides programmatic access to all platform capabilities.
Authentication
All API requests require authentication via Bearer token in the Authorization header.
curl -X GET "https://api.omic.ai/v1/targets" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json"
Base URL
https://api.omic.ai/v1
Endpoints
POST
/targets/discoverRun target discovery analysis on expression data.
Request Body
{
"expression_matrix": "base64_encoded_csv",
"metadata": "base64_encoded_csv",
"condition_column": "condition",
"case_value": "disease",
"control_value": "control",
"options": {
"include_druggability": true,
"min_fold_change": 1.5,
"max_pvalue": 0.05
}
}Response
{
"job_id": "td_abc123",
"status": "processing",
"estimated_time": "2-4 hours",
"webhook_url": "https://api.omic.ai/v1/jobs/td_abc123"
}POST
/compounds/generateGenerate novel compounds optimized for a target.
Request Body
{
"target_uniprot": "P00533",
"binding_site": {
"residues": ["K721", "L834", "T790"]
},
"constraints": {
"mw_range": [300, 500],
"logp_range": [1, 5],
"hbd_max": 3,
"hba_max": 7
},
"num_molecules": 100
}Response
{
"job_id": "cg_xyz789",
"status": "processing",
"estimated_time": "4-8 hours"
}GET
/jobs/{job_id}Check the status of a running job.
Response
{
"job_id": "td_abc123",
"status": "completed",
"created_at": "2024-01-15T10:30:00Z",
"completed_at": "2024-01-15T12:45:00Z",
"results_url": "https://api.omic.ai/v1/results/td_abc123"
}Rate Limits
| Plan | Requests/min | Concurrent Jobs |
|---|---|---|
| AI Scientist ($39/mo) | 60 | 2 |
| AI Research Team ($399/mo) | 300 | 10 |
| Enterprise | Custom | Custom |
Error Codes
| Code | Description |
|---|---|
| 400 | Bad Request - Invalid parameters |
| 401 | Unauthorized - Invalid or missing API key |
| 429 | Rate Limit Exceeded |
| 500 | Internal Server Error |