Authentication
All requests require an API key in the Authorization header. Keys are issued through the EpochCore dashboard or via the /install CLI setup.
Authorization: Bearer YOUR_API_KEY
Endpoints
8 Core Endpoints
Everything you need to submit circuits, query backends, screen molecules, and orchestrate multi-model consensus.
POST
/v1/circuits/run
+
Submit a quantum circuit for execution on an available backend.
Request
curl -X POST \
https://epochcore-quantum-api.epochcoreras.workers.dev/v1/circuits/run \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"qasm": "OPENQASM 3.0; qubit[2] q; h q[0]; cx q[0], q[1]; measure q;",
"backend": "ibm_fez",
"shots": 4096,
"optimization_level": 3
}'
Response
{
"job_id": "qj_8f3a1b2c4d5e6f7a",
"status": "queued",
"backend": "ibm_fez",
"shots": 4096,
"estimated_time_ms": 1200,
"created_at": "2026-03-03T12:00:00Z"
}
GET
/v1/backends
+
List all available quantum backends with real-time status.
Request
curl https://epochcore-quantum-api.epochcoreras.workers.dev/v1/backends \
-H "Authorization: Bearer YOUR_API_KEY"
Response
{
"backends": [
{
"id": "ibm_fez",
"name": "IBM Heron R2 — Fez",
"qubits": 156,
"status": "online",
"queue_depth": 3,
"avg_cnot_error": 0.0042
},
{
"id": "ibm_torino",
"name": "IBM Heron R2 — Torino",
"qubits": 133,
"status": "online",
"queue_depth": 0,
"avg_cnot_error": 0.0038
}
],
"total": 6
}
GET
/v1/backends/{id}/calibration
+
Get calibration data for a specific backend.
Request
curl https://epochcore-quantum-api.epochcoreras.workers.dev/v1/backends/ibm_fez/calibration \
-H "Authorization: Bearer YOUR_API_KEY"
Response
{
"backend_id": "ibm_fez",
"last_calibrated": "2026-03-03T08:30:00Z",
"t1_avg_us": 285.4,
"t2_avg_us": 142.7,
"readout_error_avg": 0.0091,
"cnot_error_avg": 0.0042,
"single_qubit_error_avg": 0.00023,
"qubit_count": 156,
"connectivity": "heavy-hex"
}
POST
/v1/circuits/transpile
+
Transpile a circuit for a target backend.
Request
curl -X POST \
https://epochcore-quantum-api.epochcoreras.workers.dev/v1/circuits/transpile \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"qasm": "OPENQASM 3.0; qubit[4] q; h q[0]; cx q[0],q[1]; cx q[1],q[2]; cx q[2],q[3];",
"target_backend": "ibm_fez",
"optimization_level": 3
}'
Response
{
"transpiled_qasm": "OPENQASM 3.0; ...",
"depth": 12,
"gate_count": 18,
"cnot_count": 6,
"optimization_level": 3,
"target_backend": "ibm_fez",
"layout": [0, 14, 18, 19]
}
GET
/v1/jobs/{id}
+
Get job status and results.
Request
curl https://epochcore-quantum-api.epochcoreras.workers.dev/v1/jobs/qj_8f3a1b2c4d5e6f7a \
-H "Authorization: Bearer YOUR_API_KEY"
Response
{
"job_id": "qj_8f3a1b2c4d5e6f7a",
"status": "completed",
"backend": "ibm_fez",
"shots": 4096,
"results": {
"counts": {
"00": 2018,
"11": 2078
},
"quasi_dists": [{ "00": 0.4926, "11": 0.5074 }]
},
"execution_time_ms": 847,
"created_at": "2026-03-03T12:00:00Z",
"completed_at": "2026-03-03T12:00:01Z"
}
POST
/v1/moleculegen/screen
+
Submit a molecular screening job.
Request
curl -X POST \
https://epochcore-quantum-api.epochcoreras.workers.dev/v1/moleculegen/screen \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"smiles": ["CC(=O)Oc1ccccc1C(=O)O", "c1ccc2c(c1)cc1ccc3cccc4ccc2c1c34"],
"target_protein": "EGFR",
"basis_set": "sto-3g",
"ansatz": "UCCSD",
"scoring": ["binding_affinity", "toxicity", "solubility"]
}'
Response
{
"job_id": "mg_4a7b9c2d1e3f5a6b",
"status": "processing",
"molecules_submitted": 2,
"estimated_time_ms": 25000,
"backend_allocated": "ibm_pittsburgh"
}
POST
/v1/council/chat
+
Multi-model consensus chat (OpenAI-compatible).
Request
curl -X POST \
https://epochcore-quantum-api.epochcoreras.workers.dev/v1/council/chat \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-d '{
"model": "council-v1",
"messages": [
{ "role": "user", "content": "Explain the advantages of VQE over QAOA for molecular ground-state energy estimation." }
],
"council_models": ["claude-opus-4-6", "gpt-4o", "gemini-2.5-pro"],
"consensus_strategy": "weighted_vote"
}'
Response
{
"id": "council-8f3a1b2c",
"object": "chat.completion",
"model": "council-v1",
"choices": [{
"index": 0,
"message": {
"role": "assistant",
"content": "VQE offers several advantages over QAOA for molecular ground-state estimation..."
},
"consensus_score": 0.94
}],
"council_metadata": {
"models_used": 3,
"agreement_ratio": 0.94,
"latency_ms": 2340
}
}
GET
/v1/health
+
Platform health check.
Request
curl https://epochcore-quantum-api.epochcoreras.workers.dev/v1/health \
-H "Authorization: Bearer YOUR_API_KEY"
Response
{
"status": "operational",
"version": "1.4.2",
"uptime_percent": 99.97,
"backends_online": 6,
"backends_total": 6,
"total_qubits": 913,
"active_jobs": 42,
"timestamp": "2026-03-03T12:00:00Z"
}