Submit Job and Poll Results
A 4-step recipe with IBM Quantum. We can help you get access.
Recipe · 4 steps
Submit Job and Poll Results
with IBM Quantum
Run a Qiskit Runtime primitive job on a backend and retrieve its results.
- Confirm the target backend is reachable and report its operational state and queue length before submitting work to it.
- Invoke the Qiskit Runtime primitive with the supplied program id, backend, and params. The returned job id is used to poll status and fetch results.
- Read the job details and branch on its status. A terminal status ends the poll loop and routes to the result fetch; any non-terminal status loops back to poll again.
- Retrieve the job's final result payload once the job has completed successfully.
What you'll need to have ready
- accessToken: IBM Cloud IAM bearer token used in the Authorization header.
- serviceCrn: IBM Cloud Service CRN identifying the Qiskit Runtime instance.
- apiVersion: API version date sent in the IBM-API-Version header (e.g. 2026-03-15).
- backend: Name of the backend on which to run the program (e.g. ibm_brisbane).
- programId: ID of the primitive program to execute (e.g. sampler or estimator).
- params: The primitive input params object (e.g. Sampler pubs).
For your developer
Arazzo workflow ibm-quantum:submit-job-and-poll-results, 4 operations: get_backend_status → create_job → get_job → get_job_results_jid. Specs on APIs.io.