QPU Submission

Run circuits on real quantum hardware.

Coda lets you submit quantum circuits to real QPU hardware, check job status, and retrieve results. Circuits are automatically converted to the target device’s native format before submission.

Supported hardware

Use the devices method to list all available QPU backends and their current status:

1from conductorquantum import ConductorQuantum
2
3client = ConductorQuantum(token="<your-api-key>")
4devices = client.coda.qpu_devices()
5print(devices)

This returns all available QPU devices, including availability and qubit counts.

Submit a circuit

1from conductorquantum import ConductorQuantum
2
3client = ConductorQuantum(token="<your-api-key>")
4result = client.coda.qpu_submit(
5 code="from qiskit import QuantumCircuit\nqc = QuantumCircuit(2)\nqc.h(0)\nqc.cx(0, 1)\nqc.measure_all()",
6 source_framework="qiskit",
7 backend="iqm",
8 shots=100,
9)
10print(result)

The response includes a job_id for tracking.

Check job status

1from conductorquantum import ConductorQuantum
2
3client = ConductorQuantum(token="<your-api-key>")
4result = client.coda.qpu_status(job_id="<job-id>")
5print(result)

Estimate cost before submitting

Get a cost estimate without actually submitting the job:

1from conductorquantum import ConductorQuantum
2
3client = ConductorQuantum(token="<your-api-key>")
4result = client.coda.qpu_estimate_cost(
5 code="from qiskit import QuantumCircuit\nqc = QuantumCircuit(2)\nqc.h(0)\nqc.cx(0, 1)\nqc.measure_all()",
6 source_framework="qiskit",
7 backend="iqm",
8 shots=100,
9)
10print(result)
  • POST /qpu/submit: submit a circuit to QPU hardware
  • POST /qpu/status: check job status and retrieve results
  • GET /qpu/devices: list available QPU devices
  • POST /qpu/estimate-cost: estimate job cost

See the Coda API Reference for full request and response schemas.