// API Reference

REST endpoints,citable responses.

Every EigenOS endpoint returns a JSON body with a deterministic canonical hash. The hash plus your input equals the citation. Audit verdicts are signed with Ed25519.

Authentication

EigenOS uses API keys for service authentication. Generate a key from /dashboard/api-keys.

curl https://api.eigenosquantum.com/v1/bsaas/run
  -H "Authorization: Bearer eig_live_..."
  -H "Content-Type: application/json"
  -d "{\"source\":\"...\",\"shots\":1000}"

Routes

POST/api/bsaas/runAuth

Submit a circuit for multi-vendor execution. Returns vendor-by-vendor measurement results normalized to the unified schema.

{"source":"OPENQASM 3.0","backends":["origin","ibm","ionq"],"shots":1000}
POST/api/claims-auditAuth

Submit a quantum-performance claim for T5.4 audit. Returns verdict plus canonical hash plus audit ID.

{"claim":"...","circuit":"OPENQASM 3.0","evidence":{}}
POST/api/photon-transferAuth

Submit a photon transfer scenario.

{"source_backend":"origin","target_backend":"ibm","link":{"type":"photon"}}
POST/api/paddle/webhook

Paddle webhook receiver. Verifies Ed25519 signature.

GET/api/dashboard/api-keysAuth

List API keys.

POST/api/dashboard/runAuth

Run a saved circuit.

{"circuit_id":"cirq_bell_2q","backend":"ionq"}

Error codes

CodeMeaning
200OK
201Created
400Bad Request
401Unauthorized
402Payment required
403Forbidden
404Not Found
422Unprocessable
429Too Many Requests
500Internal
Back to docs index