Jobs are submitted to our platform through an SDK or via API. Jobs contain a circuit to be run, specify a backend to run it on, and any other relevant options.
backend = provider.get_backend("forte-1") # Pick a backend...circuit = QuantumCircuit(2, 2).h(0) # build your circuit...job = backend.run(circuit, shots=500) # and run it on the backend!
For a complete reference to the available job options, see our API reference, or review one of our SDK guides for examples.
When you submit a job, it will typically pass through these stages:
submitted - the request has been sent to the IonQ Quantum Cloud and the job is being checked, verified, and compiled. In Qiskit, this will show as initializing.
ready - the job has been accepted and is waiting in the queue for its target system to be available. In Qiskit, this will show as queued.
started - the job has begun running. For QPU jobs, this may indicate that the job is currently executing on ions, but it may also indicate that it is in a partially finished state (i.e., some executions of a job have finished, or some child jobs in a multicircuit job have finished). This state will show as running in our API v0.3, cloud console UI, and Qiskit.
The final state of a job may be:
completed - the job has finished and the results are available. In Qiskit, this will show as done.
canceled - the job was canceled by the user.
failed - the job failed due to an error, which will be displayed if you retrieve the job. You may also receive an email notification with information about the job failure.
Note that not all SDKs support multi-circuit job submission. Please refer to the official documentation for that SDK for current functionality.
Was this page helpful?
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"IonQ Quantum Cloud Documentation","colors":{"primary":"#FF5000","light":"#FF5000","dark":"#FF5000"},"logo":{"light":"https://mintcdn.com/ionq/KP8cXNscCAA57Ku7/media/branding/ionq-logo-light.png?fit=max\u0026auto=format\u0026n=KP8cXNscCAA57Ku7\u0026q=85\u0026s=11cad3438352638e3454cd778e5edbd2","dark":"https://mintcdn.com/ionq/KP8cXNscCAA57Ku7/media/branding/ionq-logo-dark.png?fit=max\u0026auto=format\u0026n=KP8cXNscCAA57Ku7\u0026q=85\u0026s=85d5d12a9583104a8d373ede243bb6eb","href":"/"},"favicon":"https://mintcdn.com/ionq/KP8cXNscCAA57Ku7/media/branding/favicon.png?fit=max\u0026auto=format\u0026n=KP8cXNscCAA57Ku7\u0026q=85\u0026s=82c7a4271938c62e2d0face324458e5b","api":{"openapi":["https://api.ionq.co/v0.3/api-docs","https://api.ionq.co/v0.4/api-docs"]},"appearance":{"default":"dark"},"background":{"color":{"dark":"#0F161B"}},"navbar":{"links":[],"primary":{"type":"button","label":"Sign In","href":"https://cloud.ionq.com"}},"footer":{"socials":{"twitter":"https://twitter.com/ionq_inc","github":"https://github.com/ionq","linkedin":"https://www.linkedin.com/company/ionq.co"}},"search":{"prompt":"Search for..."},"seo":{"metatags":{"og:logo":"/media/branding/ionq-logo-light.png"},"indexing":"all"},"integrations":{"ga4":{"measurementId":"G-4MVSY41MTC"}},"styling":{"latex":true},"navigation":{"global":{"anchors":[{"anchor":"Join our Slack","icon":"slack","href":"https://join.slack.com/t/ionqcommunity/shared_invite/zt-2ohj4fkvb-ErVKebhkwaP7S~lt2Gq0_w"},{"anchor":"Example Notebooks","icon":"github","href":"https://github.com/ionq-samples/"},{"anchor":"Other Resources","icon":"book-open-cover","href":"https://ionq.com/resources"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"ionq","hasAudioNarration":false,"actualSubdomain":"ionq","customDomains":["docs.ionq.com"],"gitSource":{"type":"github","owner":"ionq-samples","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6adb8b0e2d3c9c6f327a1f19","collectionId":"b88c1530-3396-4270-8569-b4fe17a1adfa","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6adb8b0e2d3c9c6f327a1f19"},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"REMOVE_BRANDING":{"status":"DISABLED"},"CONTEXTUAL_FEEDBACK":{"status":"DISABLED"},"CODE_SNIPPET_FEEDBACK":{"status":"DISABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6adb8b0e2d3c9c6f327a1f19","clientVersion":"0.0.4006","searchFilterCounts":[{"language":"default","tag":"API v0.4 (Latest)","count":29},{"language":"default","tag":"Jobs","count":20},{"language":"default","tag":"API v0.3","count":19},{"language":"default","tag":"Home","count":18},{"language":"default","tag":"SDKs","count":11},{"language":"default","tag":"Python SDKs","count":11},{"language":"default","tag":"IonQ v0.3 API","count":7},{"language":"default","tag":"User Manual","count":7},{"language":"default","tag":"Backends","count":5},{"language":"default","tag":"Guides","count":5}]},"assistantConfig":{"deflection":{"enabled":true,"email":"[email protected]"}},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-v7-file-tree","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"pause-universal-search-reconcile","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"per-site-search-delta","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-private-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-nav-generations","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"byok-sep-25","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"survey-popup.css","content":".ionq-survey-popup{--ionq-survey-bg:#ffffff;--ionq-survey-fg:#0f161b;--ionq-survey-muted:#4b5563;--ionq-survey-border:rgba(15, 22, 27, 0.1);--ionq-survey-shadow:0 12px 32px rgba(15, 22, 27, 0.18);--ionq-survey-accent:#ff5000;--ionq-survey-accent-hover:#e64800;position:fixed;right:1.25rem;bottom:1.25rem;z-index:60;box-sizing:border-box;width:min(22.5rem,calc(100vw - 2.5rem));padding:1.25rem 1.25rem 1.125rem;border:1px solid var(--ionq-survey-border);border-radius:.875rem;background:var(--ionq-survey-bg);color:var(--ionq-survey-fg);box-shadow:var(--ionq-survey-shadow);font-family:inherit;line-height:1.45;opacity:0;transform:translateY(.75rem);transition:opacity .25s ease,transform .25s ease;pointer-events:none}.ionq-survey-popup--visible{opacity:1;transform:translateY(0);pointer-events:auto}html.dark .ionq-survey-popup{--ionq-survey-bg:#161f26;--ionq-survey-fg:#f3f4f6;--ionq-survey-muted:#a8b3bd;--ionq-survey-border:rgba(255, 255, 255, 0.1);--ionq-survey-shadow:0 12px 32px rgba(0, 0, 0, 0.5)}.ionq-survey-popup__close{position:absolute;top:.5rem;right:.5rem;width:1.75rem;height:1.75rem;padding:0;border:0;border-radius:999px;background:0 0;color:var(--ionq-survey-muted);font-size:1.25rem;line-height:1;cursor:pointer}.ionq-survey-popup__close:focus-visible,.ionq-survey-popup__close:hover{background:var(--ionq-survey-border);color:var(--ionq-survey-fg);outline:0}.ionq-survey-popup__badge{display:inline-block;margin-bottom:.625rem;padding:.125rem .5rem;border-radius:999px;background:rgba(255,80,0,.12);color:var(--ionq-survey-accent);font-size:.6875rem;font-weight:600;letter-spacing:.04em;text-transform:uppercase}.ionq-survey-popup__title{margin:0 1.5rem .375rem 0;font-size:1rem;font-weight:600;line-height:1.3}.ionq-survey-popup__body{margin:0 0 1rem;color:var(--ionq-survey-muted);font-size:.875rem}.ionq-survey-popup__actions{display:flex;flex-wrap:wrap;gap:.5rem .75rem;align-items:center}.ionq-survey-popup__cta{display:inline-flex;align-items:center;padding:.5rem .875rem;border-radius:.5rem;background:var(--ionq-survey-accent);color:#fff!important;font-size:.875rem;font-weight:600;text-decoration:none!important;transition:background .15s ease}.ionq-survey-popup__cta:focus-visible,.ionq-survey-popup__cta:hover{background:var(--ionq-survey-accent-hover);outline:0}.ionq-survey-popup__later{padding:.5rem .25rem;border:0;background:0 0;color:var(--ionq-survey-muted);font-size:.875rem;font-weight:500;cursor:pointer}.ionq-survey-popup__later:focus-visible,.ionq-survey-popup__later:hover{color:var(--ionq-survey-fg);text-decoration:underline;outline:0}@media (max-width:640px){.ionq-survey-popup{right:.75rem;left:.75rem;bottom:.75rem;width:auto}}@media (prefers-reduced-motion:reduce){.ionq-survey-popup{transition:none;transform:none}}"}],"page":{"pagePath":"user-manual/jobs","slug":"/user-manual/jobs","pageMetadata":{"title":"Jobs","description":"Jobs are tasks running on IonQ systems, usually containing a circuit to run on a QPU.","href":"/user-manual/jobs"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Jobs are tasks running on IonQ systems, usually containing a circuit to run on a QPU.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,em:`em`,hr:`hr`,li:`li`,p:`p`,pre:`pre`,span:`span`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Heading,Warning}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!Warning)_missingMdxReference(`Warning`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`Jobs are submitted by users of a `,_jsx(_components.a,{href:`/user-manual/projects`,children:`Project`}),` and contain an `,_jsx(_components.code,{children:`input`}),` that tells the backend what to do—such as running a circuit.`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`submitting-jobs`,children:`Submitting Jobs`}),`\n`,_jsxs(_components.p,{children:[`Jobs are submitted to our platform through an `,_jsx(_components.a,{href:`/sdks`,children:`SDK`}),` or `,_jsx(_components.a,{href:`/guides/direct-api-submission`,children:`via API`}),`. Jobs contain a circuit to be run, specify a backend to run it on, and any other relevant options.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`3`,language:`python`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`python`,children:_jsxs(_components.code,{language:`python`,numberOfLines:`3`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`backend `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` provider.get_backend(`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`\"forte-1\"`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`) `}),_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# Pick a backend...`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`circuit `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` QuantumCircuit(`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`2`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`, `}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`2`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`).h(`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`0`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`) `}),_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# build your circuit...`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`job `}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` backend.run(circuit, `}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#9CDCFE`},children:`shots`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`=`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:`500`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`) `}),_jsx(_components.span,{style:{color:`#6E7781`,\"--shiki-dark\":`#6A9955`},children:`# and run it on the backend!`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`For a complete reference to the available `,_jsx(_components.code,{children:`job`}),` options, see our `,_jsx(_components.a,{href:`/api-reference/v0.4/jobs/create-job`,children:`API reference`}),`, or review one of our `,_jsx(_components.a,{href:`/sdks/qiskit/index`,children:`SDK guides`}),` for examples.`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`job-status`,children:`Job Status`}),`\n`,_jsxs(_components.p,{children:[`When you submit a job, it will typically pass through `,_jsx(_components.a,{href:`/api-reference/v0.4/jobs/get-job#response-status`,children:`these stages`}),`:`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`submitted`}),` - the request has been sent to the IonQ Quantum Cloud and the job is being checked, verified, and compiled. In Qiskit, this will show as `,_jsx(_components.code,{children:`initializing`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`ready`}),` - the job has been accepted and is waiting in the queue for its target system to be available. In Qiskit, this will show as `,_jsx(_components.code,{children:`queued`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`started`}),` - the job has begun running. For QPU jobs, this may indicate that the job is currently executing on ions, but it may also indicate that it is in a partially finished state (i.e., some executions of a job have finished, or some child jobs in a multicircuit job have finished). This state will show as `,_jsx(_components.code,{children:`running`}),` in our API v0.3, cloud console UI, and Qiskit.`]}),`\n`]}),`\n`,_jsx(_components.p,{children:`The final state of a job may be:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`completed`}),` - the job has finished and the results are available. In Qiskit, this will show as `,_jsx(_components.code,{children:`done`}),`.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`canceled`}),` - the job was canceled by the user.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`failed`}),` - the job failed due to an error, which will be displayed if you retrieve the job. You may also receive an email notification with information about the job failure.`]}),`\n`]}),`\n`,_jsx(_components.hr,{}),`\n`,_jsx(Heading,{level:`2`,id:`multi-circuit-jobs`,children:`Multi-circuit Jobs`}),`\n`,_jsxs(_components.p,{children:[`To pass `,_jsx(_components.em,{children:`multiple`}),` circuits within a single job, submit them inside of a `,_jsx(_components.code,{children:`list[]`}),` as the `,_jsx(_components.code,{children:`input`}),`, for example:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`19`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`19`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`{`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:` \"input\"`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:`:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` [`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:` \"format\"`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"ionq.circuit.v0\",`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:` \"qubits\"`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 1,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:` \"circuit\"`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:`:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` [{ `}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`\"gate\"`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"h\",`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"target\":`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:` 0`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }]`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:` \"format\"`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"ionq.circuit.v0\",`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:` \"qubits\"`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 1,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:` \"circuit\"`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:`:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` [{ `}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`\"gate\"`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"h\",`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"target\":`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:` 0`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }]`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` },`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` {`})}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:` \"format\"`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"ionq.circuit.v0\",`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:` \"qubits\"`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 1,`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:` \"circuit\"`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:`:`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` [{ `}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`\"gate\"`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#DCDCAA`},children:`:`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"h\",`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` \"target\":`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:` 0`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` }]`})]}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` }`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:` ]`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`}`})}),`\n`]})})}),`\n`,_jsx(Warning,{children:`Note that not all SDKs support multi-circuit job submission. Please refer to the official documentation for that SDK for current functionality.`})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Jobs","description":"Jobs are tasks running on IonQ systems, usually containing a circuit to run on a QPU.","href":"/user-manual/jobs"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Submitting Jobs","slug":"submitting-jobs","depth":2,"children":[]},{"title":"Job Status","slug":"job-status","depth":2,"children":[]},{"title":"Multi-circuit Jobs","slug":"multi-circuit-jobs","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/ionq/76975e31ca3d94be/survey-popup.js"],"subdomain":"ionq","siteName":"IonQ Quantum Cloud Documentation","title":"Jobs - IonQ Quantum Cloud Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-06-30T15:17:17.521Z","originalFileLocation":"user-manual/jobs.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"dark\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Jobs are tasks running on IonQ systems, usually containing a circuit to run on a QPU.\">\u003cmeta data-mint-head name=\"application-name\" content=\"IonQ Quantum Cloud Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/ionq/kNvIbD7sfYoz1On3/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/ionq/kNvIbD7sfYoz1On3/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/ionq/kNvIbD7sfYoz1On3/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/ionq/kNvIbD7sfYoz1On3/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/ionq/kNvIbD7sfYoz1On3/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/ionq/kNvIbD7sfYoz1On3/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/ionq/kNvIbD7sfYoz1On3/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/ionq/kNvIbD7sfYoz1On3/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/ionq/kNvIbD7sfYoz1On3/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Jobs - IonQ Quantum Cloud Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Jobs are tasks running on IonQ systems, usually containing a circuit to run on a QPU.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"IonQ Quantum Cloud Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.ionq.com/user-manual/jobs\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://ionq.mintlify.app/_mintlify/api/og/v2?division=User+Manual\u0026amp;title=Jobs\u0026amp;description=Jobs+are+tasks+running+on+IonQ+systems%2C+usually+containing+a+circuit+to+run+on+a+QPU.\u0026amp;theme=f6791b5e02266258dbd08105\u0026amp;signature=2d5dfecef15942153e6ddfe46a2f9daf8ae359fb94dba7207ef3bcc6e3d2ea46\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Jobs - IonQ Quantum Cloud Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Jobs are tasks running on IonQ systems, usually containing a circuit to run on a QPU.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://ionq.mintlify.app/_mintlify/api/og/v2?division=User+Manual\u0026amp;title=Jobs\u0026amp;description=Jobs+are+tasks+running+on+IonQ+systems%2C+usually+containing+a+circuit+to+run+on+a+QPU.\u0026amp;theme=f6791b5e02266258dbd08105\u0026amp;signature=2d5dfecef15942153e6ddfe46a2f9daf8ae359fb94dba7207ef3bcc6e3d2ea46\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/ionq/kNvIbD7sfYoz1On3/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"IonQ Quantum Cloud Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#FF5000\">\u003cmeta data-mint-head name=\"og:logo\" content=\"/media/branding/ionq-logo-light.png\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.ionq.com/user-manual/jobs\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/user-manual/jobs.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.ionq.com/#organization\",\"name\":\"IonQ Quantum Cloud Documentation\",\"url\":\"https://docs.ionq.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/ionq/KP8cXNscCAA57Ku7/media/branding/ionq-logo-light.png?fit=max\u0026auto=format\u0026n=KP8cXNscCAA57Ku7\u0026q=85\u0026s=11cad3438352638e3454cd778e5edbd2\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.ionq.com#website\",\"name\":\"IonQ Quantum Cloud Documentation\",\"url\":\"https://docs.ionq.com\",\"publisher\":{\"@id\":\"https://docs.ionq.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.ionq.com/user-manual/jobs#webpage\",\"url\":\"https://docs.ionq.com/user-manual/jobs\",\"name\":\"Jobs\",\"description\":\"Jobs are tasks running on IonQ systems, usually containing a circuit to run on a QPU.\",\"dateModified\":\"2026-06-30T15:17:17.521Z\",\"isPartOf\":{\"@id\":\"https://docs.ionq.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.ionq.com/user-manual/jobs#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.ionq.com/user-manual/jobs#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"User Manual\",\"item\":\"https://docs.ionq.com/user-manual/accounts\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Jobs\",\"item\":\"https://docs.ionq.com/user-manual/jobs\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.ionq.com/user-manual/jobs#article\",\"headline\":\"Jobs\",\"name\":\"Jobs\",\"description\":\"Jobs are tasks running on IonQ systems, usually containing a circuit to run on a QPU.\",\"url\":\"https://docs.ionq.com/user-manual/jobs\",\"mainEntityOfPage\":{\"@id\":\"https://docs.ionq.com/user-manual/jobs#webpage\"},\"dateModified\":\"2026-06-30T15:17:17.521Z\",\"publisher\":{\"@id\":\"https://docs.ionq.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.ionq.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"IonQ Quantum Cloud Documentation\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"IonQ Quantum Cloud Documentation","nav":{"global":{"anchors":[{"anchor":"Join our Slack","icon":"slack","href":"https://join.slack.com/t/ionqcommunity/shared_invite/zt-2ohj4fkvb-ErVKebhkwaP7S~lt2Gq0_w"},{"anchor":"Example Notebooks","icon":"github","href":"https://github.com/ionq-samples/"},{"anchor":"Other Resources","icon":"book-open-cover","href":"https://ionq.com/resources"}]},"tabs":[{"tab":"Home","groups":[{"group":"Introduction","pages":[{"title":"IonQ Documentation","sidebarTitle":"IonQ Documentation","mode":"wide","href":""}]},{"group":"Features","pages":[{"title":"Simulation with Noise Models","href":"/features/simulation-with-noise-models"},{"title":"Native Gates","href":"/features/getting-started-with-native-gates"},{"title":"Error Mitigation - Debiasing","href":"/features/error-mitigation-debiasing"}]},{"group":"Guides","pages":[{"title":"Managing API keys","href":"/guides/managing-api-keys"},{"title":"Job Cost and Usage","href":"/guides/job-cost-and-usage"},{"title":"Direct API Submissions","href":"/guides/direct-api-submission"},{"title":"QPU Submission Checklist","href":"/guides/qpu-submission-checklist"},{"title":"QAOA solve with Fire Opal","href":"/guides/qaoa-solve-with-fire-opal"}]},{"group":"User Manual","pages":[{"title":"Your Account","href":"/user-manual/accounts"},{"title":"Backends","description":"Trapped-ion QPU hardware and QPU software simulators","href":"/user-manual/backends"},{"title":"Jobs","href":"/user-manual/jobs"},{"title":"Organizations","description":null,"href":"/user-manual/organizations"},{"title":"Projects","href":"/user-manual/projects"},{"title":"Platform Systems","mode":"wide","href":"/user-manual/platform-systems"},{"title":"Glossary","href":"/user-manual/glossary"}]},{"group":"Access Partners","pages":[{"title":"Amazon Braket","href":"/partners/amazon-braket"}]},{"group":"Integrations","pages":[{"title":"Connecting a SAML Identity Provider","href":"/guides/connecting-saml-identity-providers"}]}]},{"tab":"SDKs","pages":[{"title":"SDKs","href":"/sdks"}]},{"tab":"API v0.4 (Latest)","pages":[{"title":"API v0.4 (Latest)","href":"/api-reference/v0.4/introduction"}]},{"tab":"API v0.3","pages":[{"title":"API v0.3","href":"/api-reference/v0.3/introduction"}]}]},"title":"Jobs - IonQ Quantum Cloud Documentation","buildId":"dpl_2xiSHD9XEvLsPGPcfoMtkLTB3dy9","deploymentId":"dpl_2xiSHD9XEvLsPGPcfoMtkLTB3dy9","dynamics":[],"chunks":[]}