Skip to navigation
Capabilities

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 list method to see all available QPU backends and their current status:

from conductorquantum import ConductorQuantum
client = ConductorQuantum(token="<your-api-key>")
devices = client.coda.qpus.list()
print(devices)

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

Submit a circuit

from conductorquantum import ConductorQuantum
client = ConductorQuantum(token="<your-api-key>")
result = client.coda.qpus.run(
    code="from qiskit import QuantumCircuit\nqc = QuantumCircuit(2)\nqc.h(0)\nqc.cx(0, 1)\nqc.measure_all()",
    source_framework="qiskit",
    backend="iqm",
    shots=100,
)
print(result)

The response includes a job_id for tracking.

Optional team_id bills an Enterprise team wallet. See Teams and team wallets.

Check job status

from conductorquantum import ConductorQuantum
client = ConductorQuantum(token="<your-api-key>")
result = client.coda.qpus.status(job_id="<job-id>")
print(result)

Estimate cost before submitting

Get a cost estimate without actually submitting the job:

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

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