IBM Quantum (Unofficial) icon

IBM Quantum (Unofficial)

Build, run and retrieve quantum circuits on the IBM Quantum Platform

Job → Submit to Estimator

AI-generated

Summary

Submits an ISA-transpiled circuit to IBM Quantum’s Estimator primitive for expectation-value measurements, with optional parameter bindings and precision, resilience, twirling, and execution settings. The operation returns the submitted job details for tracking and retrieving results.

Inputs

  • Backend Name or ID (required) — Backend to run the circuit on. Choose one from the list or provide its ID; the circuit must already be transpiled for that backend.
  • Circuit Format and Circuit (required) — Submit either an OpenQASM 3 string or a zlib-compressed, base64-encoded QPY circuit. The circuit must be ISA-compatible with the selected backend.
  • Parameters — Bindings for a parameterized circuit, supplied as a JSON object keyed by parameter name or as an array matched to parameter names in sorted order. Leave empty for a fixed circuit.
  • Observables — One Pauli string, such as "ZZ", or an array of strings using I, X, Y, and Z. Each string must have one letter per circuit qubit; IBM validates the length at submission.
  • Precision — Target precision attached to each PUB; defaults to 0, which uses the backend default.
  • Default Precision — Precision used for PUBs without their own precision. Defaults to 0, which omits this option.
  • Seed Estimator — Optional integer seed from 0 to 2147483647 for repeatable Estimator sampling. Leave empty for IBM to choose.
  • Resilience Level — Error-mitigation level: 0 (none), 1 (minimal, default), or 2 (medium). Higher levels require more runtime.
  • Dynamical Decoupling — Optionally applies decoupling pulses to idle qubits; the accompanying options can set slack placement, scheduling, pulse sequence, and reset handling.
  • Gate Twirling — Optionally enables Pauli gate twirling. IBM rejects gate twirling for circuits with fractional gates, including parameterized RX or RZZ gates.
  • Measurement Twirling — Optionally enables measurement twirling to reduce readout errors.
  • Twirling Options — Optional settings for twirling, including randomizations, shots per randomization, and strategy. These also apply when twirling is enabled by Resilience Level 2.
  • Execution Options — Optional execution settings such as qubit initialization and repetition delay. The measurement type option is for Sampler and is not applicable here.
  • Resilience Options — Optional fine-tuning for mitigation, including measurement mitigation, noise learning, PEC, and ZNE settings. Some mitigation methods are unsupported for fractional-gate circuits.
  • Session ID — Optional session or batch ID for running the job in a session.
  • Calibration ID — Optional calibration ID, limited to 100 characters. Leave empty to use the current calibration.
  • Max Cost (Seconds) — Optional runtime limit up to 10800 seconds. Zero omits the limit.
  • Tags — Optional comma-separated job tags for filtering jobs later.
  • Private — Optionally marks the job private, subject to plan support. For private jobs, IBM deletes the input at completion and deletes results after they are read.
  • Additional Options — Optional JSON for advanced Estimator primitive options. Dedicated fields and option collections override matching keys.
  • Log Level — Optional IBM job log verbosity; leave at Default unless debugging.

Output shape

A single job record

Contains the submitted job details, including its ID and status for later tracking. The response also reports the calibration actually used.

Links

Discussion