REST API Reference
Endpoints the web app uses, callable with your session token.
All endpoints are under https://quantum-hub.app/gw. Marked ones need Authorization: Bearer <key>, using a personal API key from your Profile:
curl -H "Authorization: Bearer qh_..." https://quantum-hub.app/gw/jobs| Method and path | What it does |
|---|---|
GET /backends | Simulator and hardware backends, with queue length |
POST /jobs 🔒 | Submit { qasm, shots, name?, backendId? } |
GET /jobs 🔒 | Your jobs, newest first |
GET /jobs/{id} 🔒 | One job, with counts when done |
DELETE /jobs/{id} 🔒 | Cancel a queued or running job |
GET /registry | Published circuits; ?q= searches |
GET /registry/{id} | One circuit with versions and README |
GET /projects 🔒 | Your projects |
GET /apis | Published APIs; ?q= searches |
GET /apis/{name} | One API: parameters and limits |
POST /apis/{name}/run 🔒 | Call it with { params?, shots? }; ?wait=N waits up to 30 s for the result |
Submitting a job from a script:
curl -X POST https://quantum-hub.app/gw/jobs \
-H "Authorization: Bearer qh_..." -H "Content-Type: application/json" \
-d '{"qasm": "OPENQASM 2.0; include \"qelib1.inc\"; qreg q[1]; creg c[1]; h q[0]; measure q -> c;", "shots": 100}'Then poll GET /jobs/{id} until status is completed.