For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
OverviewCodaControlAPI ReferenceChangelog
OverviewCodaControlAPI ReferenceChangelog
  • Getting Started
    • Overview
    • Quickstart
  • MCP
    • MCP Integration
  • Capabilities
    • Simulation
    • Transpilation
    • QPU Submission
    • Agents
  • Node
    • Overview
    • Integration Guide
    • Protocol
    • QubiC Example
LogoLogo
On this page
  • Supported hardware
  • Submit a circuit
  • Check job status
  • Estimate cost before submitting
  • Related endpoints
Capabilities

QPU Submission

Run circuits on real quantum hardware.
Was this page helpful?
Built with

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:

1from conductorquantum import ConductorQuantum
2
3client = ConductorQuantum(token="<your-api-key>")
4devices = client.coda.qpus.list()
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.qpus.run(
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.qpus.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.qpus.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)

Related endpoints

  • 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.