Submit up to 20 independent runs
Each item is submitted exactly as POST /v1/runs would submit it — validated, priced and charged on its own. Items are independent: a failure (bad circuit, unknown target, not enough credits) is reported per item with its HTTP status, and the runs that succeeded are NOT rolled back. partial is true when some, but not all, items failed.
Rate limiting is per item too: every item costs one unit of the same per-minute run budget a single POST /v1/runs costs. When fewer units remain than the batch has items, the items that fit are submitted and the rest fail on their own with errorStatus 429 (partial = true); a batch that arrives with no budget left is refused as a whole with 429, as a single submit would be.
Request
- Base URL: https://api.roroquantum.com
- URL: https://api.roroquantum.com/v1/runs/batch
- Auth: HTTP bearer
Request body
Example request
{
"runs": [
{
"machineTargetId": "roro.sim.sv",
"targetId": "roro.sim.sv",
"shots": 5000,
"qasm": "OPENQASM 2.0; include \"qelib1.inc\"; qreg q[2]; creg c[2]; h q[0]; cx q[0],q[1]; measure q -> c;",
"tags": {
"user": "u_42"
},
"resilience": {
"level": 1,
"zne": {
"observable": "ZZ"
}
}
}
]
}Response
One result per item, in order
Example response
{
"results": [
{
"ok": true,
"run": {
"id": "8f3a1c2e-…",
"machineTargetId": "roro.sim.sv",
"machineName": "RoRo Statevector Simulator",
"shots": 5000,
"status": "completed",
"cost": 25,
"counts": {
"11": 2500,
"00": 2500
},
"probabilities": {
"11": 0.5,
"00": 0.5
},
"createdAt": "2026-06-05T00:00:00Z",
"effectiveShots": 5000,
"resilience": {
"circuits": 5,
"effectiveShots": 11264
}
},
"errorStatus": 402
}
],
"submitted": 2,
"failed": 1,
"partial": true
}Changes
No recorded changes to this operation across all 1 revision of this API.