POST /api/v2/batch

{
  "name": "bell-vs-ghz",
  "jobs": [
    {
      "circuit": "OPENQASM 2.0; include \"qelib1.inc\"; qreg q[2]; creg c[2]; h q[0]; cx q[0],q[1]; measure q -> c;",
      "backend": "statevector",
      "shots": 1024
    },
    {
      "circuit": "OPENQASM 2.0; include \"qelib1.inc\"; qreg q[3]; creg c[3]; h q[0]; h q[1]; h q[2]; measure q -> c;",
      "backend": "statevector",
      "shots": 512
    }
  ],
  "max_concurrent": 4
}

{
  "batch_id": "bat_9f2a3b4c",
  "tenant_id": "ten_...",
  "name": "bell-vs-ghz",
  "status": "queued",
  "total_jobs": 2,
  "created_at": "2025-01-15T10:00:00Z"
}

GET /api/v2/batch/{batch_id}

curl -H "Authorization: Bearer $QCOS_API_KEY" \
  https://api.softquantus.com/api/v2/batch/bat_9f2a3b4c

{
  "batch_id": "bat_9f2a3b4c",
  "status": "running",
  "total": 2,
  "completed": 1,
  "failed": 0,
  "queued": 0,
  "running": 1,
  "progress_pct": 50
}

GET /api/v2/batch/{batch_id}/results

curl -H "Authorization: Bearer $QCOS_API_KEY" \
  "https://api.softquantus.com/api/v2/batch/bat_9f2a3b4c/results?include_failed=false"

{
  "batch_id": "bat_9f2a3b4c",
  "status": "completed",
  "results": [
    {
      "id": "circuit-0",
      "status": "success",
      "counts": {"00": 512, "11": 512},
      "execution_time_ms": 45,
      "credits_used": 1.4
    },
    {
      "id": "circuit-1",
      "status": "success",
      "counts": {"000": 64, "001": 65, "010": 63, "011": 64, "100": 64, "101": 65, "110": 63, "111": 65},
      "execution_time_ms": 30,
      "credits_used": 0.8
    }
  ],
  "total_credits_used": 2.2,
  "wall_time_ms": 120
}

import os
import time
import json
import numpy as np
import requests

API_KEY = os.environ["QCOS_API_KEY"]
BASE_URL = "https://api.softquantus.com"
HEADERS = {"Authorization": f"Bearer {API_KEY}", "Content-Type": "application/json"}

def build_rx_circuit(angle: float) -> str:
    """Single-qubit Rx rotation, measurable on Z."""
    rad = round(angle, 6)
    return (
        f'OPENQASM 2.0; include "qelib1.inc"; '
        f'qreg q[1]; creg c[1]; '
        f'rx({rad}) q[0]; measure q[0] -> c[0];'
    )

# Sweep Rx angle from 0 to 2π in 16 steps
angles = np.linspace(0, 2 * np.pi, 16)
circuits = [
    {"circuit": build_rx_circuit(a), "backend": "statevector", "shots": 1024}
    for a in angles
]

# Submit batch
resp = requests.post(
    f"{BASE_URL}/api/v2/batch",
    headers=HEADERS,
    json={"name": "rx-sweep", "jobs": circuits}
)
resp.raise_for_status()
batch_id = resp.json()["batch_id"]
print(f"Batch submitted: {batch_id}")

# Poll until done
while True:
    s = requests.get(f"{BASE_URL}/api/v2/batch/{batch_id}", headers=HEADERS).json()
    print(f"  Status: {s['status']}")
    if s["status"] in ("completed", "partial_failure", "failed"):
        break
    time.sleep(3)

# Retrieve and display results
results = requests.get(f"{BASE_URL}/api/v2/batch/{batch_id}/results", headers=HEADERS).json()
print("\nAngle → P(|1⟩)")
for r, angle in zip(results["results"], angles):
    prob_1 = r["counts"].get("1", 0) / 1024
    bar = "█" * int(prob_1 * 30)
    print(f"  {angle:5.2f} rad  {prob_1:.3f}  {bar}")
print(f"\nTotal credits used: {results['total_credits_used']}")

POST /api/v2/batch/{batch_id}/cancel

curl -X POST \
  -H "Authorization: Bearer $QCOS_API_KEY" \
  https://api.softquantus.com/api/v2/batch/bat_9f2a3b4c/cancel

GET /api/v2/batch