When the target is "simulator", this field specifies optional noise parameters for simulation. (If these noise parameters are not provided, simulations will run on an ideal quantum computer model, without noise.) This field does not apply to qpu.* targets. When a noise model is applied, the simulator qubit limit is inherited from the modeled QPU's qubit limit. (This limit does not apply to the ideal quantum computer simulator. Please refer to the current qubit limit of the ideal quantum computer simulator.)
{"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":""},"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":"6aee3c4072e128a2ba317e75","clientVersion":"0.0.4111","searchFilterCounts":[{"language":"default","tag":"API v0.4 (Latest)","count":29},{"language":"default","tag":"Jobs","count":20},{"language":"default","tag":"Home","count":20},{"language":"default","tag":"API v0.3","count":19},{"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":"Guides","count":7},{"language":"default","tag":"User Manual","count":7},{"language":"default","tag":"Backends","count":5}]},"assistantConfig":{"deflection":{"enabled":true,"email":"support@ionq.co"}},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","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":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","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":"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":"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":"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":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","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":"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":"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":"turbopuffer-dual-write","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},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","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:0.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(0.75rem);transition:opacity 0.25s ease, transform 0.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:0.5rem;right:0.5rem;width:1.75rem;height:1.75rem;padding:0;border:0;border-radius:999px;background:transparent;color:var(--ionq-survey-muted);font-size:1.25rem;line-height:1;cursor:pointer}.ionq-survey-popup__close:hover,.ionq-survey-popup__close:focus-visible{background:var(--ionq-survey-border);color:var(--ionq-survey-fg);outline:none}.ionq-survey-popup__badge{display:inline-block;margin-bottom:0.625rem;padding:0.125rem 0.5rem;border-radius:999px;background:rgba(255, 80, 0, 0.12);color:var(--ionq-survey-accent);font-size:0.6875rem;font-weight:600;letter-spacing:0.04em;text-transform:uppercase}.ionq-survey-popup__title{margin:0 1.5rem 0.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:0.875rem}.ionq-survey-popup__actions{display:flex;flex-wrap:wrap;gap:0.5rem 0.75rem;align-items:center}.ionq-survey-popup__cta{display:inline-flex;align-items:center;padding:0.5rem 0.875rem;border-radius:0.5rem;background:var(--ionq-survey-accent);color:#ffffff!important;font-size:0.875rem;font-weight:600;text-decoration:none!important;transition:background 0.15s ease}.ionq-survey-popup__cta:hover,.ionq-survey-popup__cta:focus-visible{background:var(--ionq-survey-accent-hover);outline:none}.ionq-survey-popup__later{padding:0.5rem 0.25rem;border:0;background:transparent;color:var(--ionq-survey-muted);font-size:0.875rem;font-weight:500;cursor:pointer}.ionq-survey-popup__later:hover,.ionq-survey-popup__later:focus-visible{color:var(--ionq-survey-fg);text-decoration:underline;outline:none}@media (max-width: 640px){.ionq-survey-popup{right:0.75rem;left:0.75rem;bottom:0.75rem;width:auto}}@media (prefers-reduced-motion: reduce){.ionq-survey-popup{transition:none;transform:none}}"}],"page":{"pagePath":"api-reference/v0.3/jobs/get-a-specific-job","slug":"/api-reference/v0.3/jobs/get-a-specific-job","pageMetadata":{"openapi":"https://api.ionq.co/v0.3/api-docs GET /jobs/{UUID}","title":"Get a specific Job","description":"Retrieve a specific job by UUID.","href":"/api-reference/v0.3/jobs/get-a-specific-job"},"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: \"Retrieve a specific job by UUID.\"\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}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"openapi":"https://api.ionq.co/v0.3/api-docs GET /jobs/{UUID}","title":"Get a specific Job","description":"Retrieve a specific job by UUID.","href":"/api-reference/v0.3/jobs/get-a-specific-job"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":["/_mintlify/custom/ionq/76975e31ca3d94be/survey-popup.js"],"openApiReferenceData":{"operation":{"operationId":"getJob","summary":"Get a specific Job","description":"Retrieve a specific job by UUID.","tags":["jobs"],"parameters":["e9392f8c-aab3-4ca3-b770-8d943db1dcba","0f8a56fc-da77-47a0-8ce5-12506abc2591","81540c7f-c934-4944-8cc4-a62c4104923d"],"responses":{"200":"a2be82c7-c39d-4581-8244-f23880643328"},"x-codeSamples":[{"lang":"curl","source":"curl \"https://api.ionq.co/v0.3/jobs/617a1f8b-59d4-435d-aa33-695433d7155e\" \\\n -H \"Authorization: apiKey your-api-key\"\n"}],"method":"get","type":"path","servers":["1ff55ba4-d3b5-4b6a-84fd-0d48d03a6366"],"security":["04c8e0bd-960e-483f-a912-d854670d973a"],"path":"/jobs/{UUID}","baseUrlOptions":["https://api.ionq.co/v0.3/"],"title":"Get a specific Job","codeSamples":[{"lang":"curl","source":"curl \"https://api.ionq.co/v0.3/jobs/617a1f8b-59d4-435d-aa33-695433d7155e\" \\\n -H \"Authorization: apiKey your-api-key\"\n"}],"requiredOnlyExamples":false,"requestExampleType":"codeSamples","responseExampleType":"generated"},"dependencies":{"parameters":{"e9392f8c-aab3-4ca3-b770-8d943db1dcba":{"name":"UUID","in":"path","required":true,"example":"617a1f8b-59d4-435d-aa33-695433d7155e","description":"The UUID of the job — this UUID is provided in the response on job creation.","schema":{"type":"string","format":"uuid","isRequired":true,"description":"The UUID of the job — this UUID is provided in the response on job creation.","uniqueKey":"","typeLabel":"string\u003cuuid>"}},"0f8a56fc-da77-47a0-8ce5-12506abc2591":{"name":"exclude","in":"query","description":"Exclude certain fields from the response (e.g., `exclude=status,device_id`).","schema":{"type":"array","items":{"type":"string","uniqueKey":"items.[INDEX]","typeLabel":"string"},"description":"Exclude certain fields from the response (e.g., `exclude=status,device_id`).","uniqueKey":"","typeLabel":"string[]"}},"81540c7f-c934-4944-8cc4-a62c4104923d":{"name":"include","in":"query","description":"Only return the provided fields (e.g., `include=status,device_id`).","schema":{"type":"array","items":{"type":"string","uniqueKey":"items.[INDEX]","typeLabel":"string"},"description":"Only return the provided fields (e.g., `include=status,device_id`).","uniqueKey":"","typeLabel":"string[]"}}},"responses":{"a2be82c7-c39d-4581-8244-f23880643328":{"description":"Successfully retrieved a job","content":{"application/json":{"schema":{"type":"object","description":"A quantum job.","required":["id","status","request"],"properties":{"id":{"type":"string","format":"uuid","example":"aa54e783-0a9b-4f73-ad2f-63983b6aa4a8","description":"The UUID of a job. We'll provide the UUID initially in our response to a [job creation request](/api-reference/v0.3/jobs/create-a-job).","isRequired":true,"uniqueKey":"id","typeLabel":"string\u003cuuid>"},"status":{"type":"string","example":"completed","description":"Status of a job.","enum":["submitted","ready","running","canceled","completed","failed"],"isRequired":true,"uniqueKey":"status","typeLabel":"enum\u003cstring>"},"request":{"type":"integer","format":"unix-timestamp","readOnly":true,"example":1490932820,"description":"The point in time this job was requested.","isRequired":true,"uniqueKey":"request","typeLabel":"integer\u003cunix-timestamp>"},"name":{"type":"string","description":"A job name.","example":"My Awesome Job","uniqueKey":"name","typeLabel":"string"},"target":{"type":"string","description":"Target hardware for job to run on.","default":"simulator","enum":["qpu.harmony","qpu.aria-1","qpu.aria-2","qpu.forte-1","qpu.forte-enterprise-1","simulator"],"uniqueKey":"target","typeLabel":"enum\u003cstring>"},"noise":{"description":"When the target is \"simulator\", this field specifies optional noise parameters for simulation. (If these noise parameters are not provided, simulations will run on an ideal quantum computer model, without noise.) This field does not apply to `qpu.*` targets. When a noise model is applied, the simulator qubit limit is inherited from the modeled QPU's qubit limit. (This limit does not apply to the ideal quantum computer simulator. Please refer to the current qubit limit of the ideal quantum computer simulator.)","type":"object","properties":{"model":{"type":"string","description":"Selects a noise model to apply to a simulation job. The default, `ideal`, provides perfect simulation without noise, while other noise models like `harmony` are based on noise data collected from our actual quantum computers. Note that these are simplified noise models, not intended to exactly reproduce real quantum computations.","enum":["harmony","aria-1","ideal"],"uniqueKey":"noise.model","typeLabel":"enum\u003cstring>"},"seed":{"type":"integer","description":"This is the seed value for the pseudo-random sampling and noise generation when a system noise model is specified. The seed needs to be a positive integer between 1 and 2^31. Providing a seed is optional and allows for repeatable (i.e. non-random) outcomes. If a seed is not specified, one is chosen at random and will be provided in the output for the simulation. This field does not apply to simulations using the \"ideal\" noise model. This field also does not apply to `qpu.*` targets.","example":100,"uniqueKey":"noise.seed","typeLabel":"integer"}},"uniqueKey":"noise","typeLabel":"object"},"metadata":{"type":"object","description":"User defined metadata.","example":{"custom_key":"a string, maximum 400 chars"},"additionalProperties":true,"uniqueKey":"metadata","typeLabel":"object"},"shots":{"type":"number","description":"How many times to execute your circuit when submitting to a QPU or a \"non-ideal\" noisy simulator.","default":100,"uniqueKey":"shots","typeLabel":"number"},"error_mitigation":{"type":"object","description":"Which error mitigation methods to apply to this circuit. This may affect how the job is compiled, and what configuration can be used to fetch results.","properties":{"debias":{"type":"boolean","description":"Set to true to turn on [debiasing](/features/error-mitigation-debiasing), which can improve circuit performance by removing qubit-specific noise. _Debiasing is on by default for Aria- and Forte-class systems for jobs with 500 or more shots._","uniqueKey":"error_mitigation.debias","typeLabel":"boolean"}},"uniqueKey":"error_mitigation","typeLabel":"object"},"gate_counts":{"type":"object","description":"The number of gates used with this job.","properties":{"1q":{"type":"number","example":8,"description":"How many 1-qubit gates were used.","uniqueKey":"gate_counts.1q","typeLabel":"number"},"2q":{"type":"number","example":2,"description":"How many 2-qubit gates were used.","uniqueKey":"gate_counts.2q","typeLabel":"number"}},"uniqueKey":"gate_counts","typeLabel":"object"},"qubits":{"type":"integer","example":4,"description":"The number of qubits used with this job.","uniqueKey":"qubits","typeLabel":"integer"},"cost_model":{"type":"string","enum":["QCT","2QGE_operations"],"description":"The billing model used for this job.","uniqueKey":"cost_model","typeLabel":"enum\u003cstring>"},"cost_usd":{"type":"number","example":12.41,"description":"The cost (in US dollars) of this job.","uniqueKey":"cost_usd","typeLabel":"number"},"cost_credit":{"type":"number","example":12.41,"description":"The cost (in Credits) of this job. Present instead of `cost_usd` for organizations billed in Credits.","uniqueKey":"cost_credit","typeLabel":"number"},"estimated_cost_usd":{"type":"number","example":14.06,"description":"The estimated cost (in US dollars) of this job, computed ahead of billing.","uniqueKey":"estimated_cost_usd","typeLabel":"number"},"estimated_cost_credit":{"type":"number","example":14.06,"description":"The estimated cost (in Credits) of this job. Present instead of `estimated_cost_usd` for organizations billed in Credits.","uniqueKey":"estimated_cost_credit","typeLabel":"number"},"start":{"type":"integer","format":"unix-timestamp","example":1490932821,"description":"The point in time this job was started.","uniqueKey":"start","typeLabel":"integer\u003cunix-timestamp>"},"response":{"type":"integer","format":"unix-timestamp","readOnly":true,"example":1490932834,"description":"The point in time this job was completed.","uniqueKey":"response","typeLabel":"integer\u003cunix-timestamp>"},"execution_time":{"type":"integer","description":"The actual execution time of this job.","example":13,"uniqueKey":"execution_time","typeLabel":"integer"},"predicted_execution_time":{"type":"integer","description":"The predicted execution time of this job.","example":13,"uniqueKey":"predicted_execution_time","typeLabel":"integer"},"children":{"type":"array","description":"A list of child jobs that were created from this job.","items":{"type":"string","format":"uuid","example":"aa54e783-0a9b-4f73-ad2f-63983b6aa4a8","description":"The UUID of a job. We'll provide the UUID initially in our response to a [job creation request](/api-reference/v0.3/jobs/create-a-job).","uniqueKey":"children.items.[INDEX]","typeLabel":"string\u003cuuid>"},"uniqueKey":"children","typeLabel":"string\u003cuuid>[]"},"results_url":{"type":"string","example":"/v0.3/jobs/617a1f8b-59d4-435d-aa33-695433d7155e/results","description":"Relative API path to retrieve the results for this job. See [Get a Specific Job's Output](/api-reference/v0.3/jobs/get-a-specific-jobs-output) for more details.","uniqueKey":"results_url","typeLabel":"string"},"failure":{"type":"object","description":"Error metadata, if the job failed.","properties":{"error":{"type":"string","description":"A helpful error message.","example":"An error occurred!","uniqueKey":"failure.error","typeLabel":"string"},"code":{"type":"string","description":"A helpful error code.","example":"internal_error","uniqueKey":"failure.code","typeLabel":"string"}},"uniqueKey":"failure","typeLabel":"object"},"warning":{"type":"object","description":"Warning metadata, if a warning is necessary.","readOnly":true,"properties":{"messages":{"type":"array","description":"A list of warnings to emit.","items":{"type":"string","uniqueKey":"warning.messages.items.[INDEX]","typeLabel":"string"},"uniqueKey":"warning.messages","typeLabel":"string[]"}},"uniqueKey":"warning","typeLabel":"object"},"circuits":{"type":"integer","description":"The number of circuits of this job.","example":1,"uniqueKey":"circuits","typeLabel":"integer"},"dry_run":{"type":"boolean","example":false,"uniqueKey":"dry_run","typeLabel":"boolean"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"aa54e783-0a9b-4f73-ad2f-63983b6aa4a8","status":"completed","request":1490932820,"name":"My Awesome Job","target":"simulator","noise":{"model":"harmony","seed":100},"metadata":{"custom_key":"a string, maximum 400 chars"},"shots":100,"error_mitigation":{"debias":true},"gate_counts":{"1q":8,"2q":2},"qubits":4,"cost_model":"QCT","cost_usd":12.41,"cost_credit":12.41,"estimated_cost_usd":14.06,"estimated_cost_credit":14.06,"start":1490932821,"response":1490932834,"execution_time":13,"predicted_execution_time":13,"children":["aa54e783-0a9b-4f73-ad2f-63983b6aa4a8"],"results_url":"/v0.3/jobs/617a1f8b-59d4-435d-aa33-695433d7155e/results","failure":{"error":"An error occurred!","code":"internal_error"},"warning":{"messages":["\u003cstring>"]},"circuits":1,"dry_run":false}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"04c8e0bd-960e-483f-a912-d854670d973a":{"API_Key":{"type":"http","scheme":"apiKey","description":"API keys are associated with a user and can be created on the\n[IonQ Quantum Cloud](https://cloud.ionq.com) application. To authenticate, prefix your API Key with `apiKey ` and place it in the `Authorization` request header. Ex: `Authorization: apiKey your-api-key`\n","scopes":[],"schemeName":"API_Key"}}},"servers":{"1ff55ba4-d3b5-4b6a-84fd-0d48d03a6366":{"url":"https://api.ionq.co/v0.3/"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"apiKey","description":"API keys are associated with a user and can be created on the\n[IonQ Quantum Cloud](https://cloud.ionq.com) application. To authenticate, prefix your API Key with `apiKey ` and place it in the `Authorization` request header. Ex: `Authorization: apiKey your-api-key`\n","scopes":[],"schemeName":"API_Key"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"API keys are associated with a user and can be created on the\n[IonQ Quantum Cloud](https://cloud.ionq.com) application. To authenticate, prefix your API Key with `apiKey ` and place it in the `Authorization` request header. Ex: `Authorization: apiKey your-api-key`\n","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"API_Key","name":"Authorization"}],"title":"API_Key"}]},"originalFileLocation":"https://api.ionq.co/v0.3/api-docs"},"subdomain":"ionq","siteName":"IonQ Quantum Cloud Documentation","title":"Get a specific Job - IonQ Quantum Cloud Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2025-08-18T22:05:01.314Z","originalFileLocation":"api-reference/v0.3/jobs/get-a-specific-job.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=\"Retrieve a specific job by UUID.\">\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=\"Get a specific Job - IonQ Quantum Cloud Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Retrieve a specific job by UUID.\">\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/api-reference/v0.3/jobs/get-a-specific-job\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://ionq.mintlify.site/_mintlify/api/og/v2?division=Jobs\u0026amp;title=Get+a+specific+Job\u0026amp;description=Retrieve+a+specific+job+by+UUID.\u0026amp;theme=ca3ff32ca81c15537a09c8e7\u0026amp;signature=898b5187d6ac80c57d4207d342a9cd2f5b20fd000862644b519bf3163dc0f111\">\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=\"Get a specific Job - IonQ Quantum Cloud Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Retrieve a specific job by UUID.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://ionq.mintlify.site/_mintlify/api/og/v2?division=Jobs\u0026amp;title=Get+a+specific+Job\u0026amp;description=Retrieve+a+specific+job+by+UUID.\u0026amp;theme=ca3ff32ca81c15537a09c8e7\u0026amp;signature=898b5187d6ac80c57d4207d342a9cd2f5b20fd000862644b519bf3163dc0f111\">\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/api-reference/v0.3/jobs/get-a-specific-job\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/v0.3/jobs/get-a-specific-job.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/api-reference/v0.3/jobs/get-a-specific-job#webpage\",\"url\":\"https://docs.ionq.com/api-reference/v0.3/jobs/get-a-specific-job\",\"name\":\"Get a specific Job\",\"description\":\"Retrieve a specific job by UUID.\",\"dateModified\":\"2025-08-18T22:05:01.314Z\",\"isPartOf\":{\"@id\":\"https://docs.ionq.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.ionq.com/api-reference/v0.3/jobs/get-a-specific-job#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.ionq.com/api-reference/v0.3/jobs/get-a-specific-job#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Jobs\",\"item\":\"https://docs.ionq.com/api-reference/v0.3/jobs/get-jobs\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Get a specific Job\",\"item\":\"https://docs.ionq.com/api-reference/v0.3/jobs/get-a-specific-job\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.ionq.com/api-reference/v0.3/jobs/get-a-specific-job#apireference\",\"headline\":\"Get a specific Job\",\"name\":\"Get a specific Job\",\"description\":\"Retrieve a specific job by UUID.\",\"url\":\"https://docs.ionq.com/api-reference/v0.3/jobs/get-a-specific-job\",\"mainEntityOfPage\":{\"@id\":\"https://docs.ionq.com/api-reference/v0.3/jobs/get-a-specific-job#webpage\"},\"dateModified\":\"2025-08-18T22:05:01.314Z\",\"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\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"IonQ Quantum Cloud Documentation\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/api-reference/v0.3/jobs/get-a-specific-job.md","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","pages":[{"title":"Home","href":""}]},{"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","groups":[{"group":"IonQ v0.3 API","pages":[{"title":"Introduction","href":"/api-reference/v0.3/introduction"},{"title":"API Core Concepts","href":"/api-reference/v0.3/core-concepts"},{"title":"v0.3 Error Codes","href":"/api-reference/v0.3/error-codes"},{"title":"Writing Quantum Programs","href":"/api-reference/v0.3/writing-quantum-programs"},{"title":"Migrating from old versions","href":"/api-reference/v0.3/migrating-from-old-versions"},{"title":"Multicircuit Jobs","href":"/api-reference/v0.3/multicircuit-jobs"},{"title":"Using native gates with the IonQ API","href":"/api-reference/v0.3/native-gates-api"}]},{"group":"Jobs","pages":[{"openapi":"https://api.ionq.co/v0.3/api-docs GET /jobs","title":"Get Jobs","href":"/api-reference/v0.3/jobs/get-jobs"},{"openapi":"https://api.ionq.co/v0.3/api-docs POST /jobs","title":"Create a Job","href":"/api-reference/v0.3/jobs/create-a-job"},{"openapi":"https://api.ionq.co/v0.3/api-docs DELETE /jobs","title":"Delete many Jobs","description":"Permanently remove many jobs from our platform. This cannot be undone.","href":"/api-reference/v0.3/jobs/delete-many-jobs"},{"openapi":"https://api.ionq.co/v0.3/api-docs GET /jobs/{UUID}","title":"Get a specific Job","href":"/api-reference/v0.3/jobs/get-a-specific-job"},{"openapi":"https://api.ionq.co/v0.3/api-docs DELETE /jobs/{UUID}","title":"Delete a Job","description":"Permanently delete a job from our service. This cannot be undone.","href":"/api-reference/v0.3/jobs/delete-a-job"},{"openapi":"https://api.ionq.co/v0.3/api-docs GET /jobs/{UUID}/results","title":"Get a Job's output","href":"/api-reference/v0.3/jobs/get-a-specific-jobs-output"},{"openapi":"https://api.ionq.co/v0.3/api-docs PUT /jobs/{UUID}/status/cancel","title":"Cancel a Job","href":"/api-reference/v0.3/jobs/cancel-a-job"},{"openapi":"https://api.ionq.co/v0.3/api-docs PUT /jobs/status/cancel","title":"Cancel many Jobs","href":"/api-reference/v0.3/jobs/cancel-many-jobs"}]},{"group":"Characterizations","pages":[{"openapi":"https://api.ionq.co/v0.3/api-docs GET /characterizations/backends/{backend}","title":"Get All Backend Characterizations","href":"/api-reference/v0.3/characterizations/get-all-backend-characterizations"},{"openapi":"https://api.ionq.co/v0.3/api-docs GET /characterizations/backends/{backend}/current","title":"Get the Most Recent Backend Characterization","href":"/api-reference/v0.3/characterizations/get-the-most-recent-backend-characterization"},{"openapi":"https://api.ionq.co/v0.3/api-docs GET /characterizations/{UUID}","title":"Get a Characterization","href":"/api-reference/v0.3/characterizations/get-a-characterization"}]},{"group":"Backends","pages":[{"openapi":"https://api.ionq.co/v0.3/api-docs GET /backends","title":"Get Backends","href":"/api-reference/v0.3/backends/get-backends"}]}]}]},"basePath":"","title":"Get a specific Job - IonQ Quantum Cloud Documentation","buildId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","deploymentId":"dpl_DqYu5MPb49gWBBbUGgpHQUmCHY3P","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-CybtLBIt.js","utils-BMLj2fvV.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-B6In562Y.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-Dr8Mfhp9.js","snippetPresets-2rmQvMVl.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-WMqJYdZj.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-CJ-MlPHu.js","shallow-dY3TMRCk.js","getApiPlaygroundDisplay-v-1B2bKm.js","CodeSnippet-BDhiTB7U.js","CodeSnippets-D9hnzQcS.js","Page-C4GwDT3_.js","getPastedJson-Th2V45jI.js","icon-BQXch1W9.js","MethodPill-BCqUneP3.js","DuplicateIcon-Q_-bhurZ.js","createIcon-DUjLHRqp.js","DynamicMarkdown-B-f2cqXQ.js","SectionHeading-Da5NsV4v.js","axios-vUo_bRtp.js","Markdown-D13FWkIM.js","clsx-D3Isdib3.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-C-XZBk9h.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink--qIqmmVG.js"]}