Actions24
- Account Actions
- Backend Actions
- Circuit Actions
- Job Actions
- Session Actions
Job → Submit to Estimator
AI-generatedSummary
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.