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 pathWhat it does
GET /backendsSimulator 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 /registryPublished circuits; ?q= searches
GET /registry/{id}One circuit with versions and README
GET /projects 🔒Your projects
GET /apisPublished 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.