> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ionq.com/llms.txt
> Use this file to discover all available pages before exploring further.

> Retrieve detailed information about a specific job.

# Get job

Retrieve detailed information about a specific [job](/user-manual/glossary#job) using its unique identifier. This returns the job's current [status](/user-manual/glossary#job-status), execution details, results (if completed), and metadata including timing information, gate counts, and failure details if applicable.

Learn more about [viewing job results](/guides/direct-api-submission#retrieving-job-results).


## OpenAPI

````yaml https://api.ionq.co/v0.4/api-docs GET /jobs/{UUID}
openapi: 3.0.3
info:
  contact:
    email: support@ionq.co
    name: IonQ
    url: https://ionq.com/
  description: |
    *Last updated: August 1, 2026*
    IonQ's API for accessing the IonQ Quantum Cloud platform

    Please subscribe for automated updates when we perform maintenance or
    experience an outage.

    In addition, you may use the [status endpoint](#tag/status) to check the
    current status of our API.

    ## Authentication

    <SecurityDefinitions />
  title: IonQ Cloud Platform API
  version: v0.4
servers:
  - url: https://api.ionq.co/v0.4
security: []
paths:
  /jobs/{UUID}:
    get:
      operationId: GetJob
      parameters:
        - description: >-
            The UUID of the job — this UUID is provided in the response on job
            creation.
          in: path
          name: UUID
          required: true
          schema:
            type: string
      responses:
        '200':
          description: Successfully retrieved a job.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetJobResponse'
              examples:
                Single Circuit:
                  value:
                    id: e1a09d90-b2ba-4ea5-9fd7-4bfc14eac524
                    status: completed
                    type: ionq.circuit.v1
                    backend: qpu.forte-1
                    dry_run: false
                    submitter_id: 64b03577072d45001c85e9c4
                    project_id: 1333d459-cf47-4a5e-acc1-8d4eb4f7b025
                    parent_job_id: null
                    child_job_ids: null
                    session_id: null
                    metadata: null
                    name: Bell state
                    submitted_at: '2026-06-11T20:47:05.440Z'
                    started_at: '2026-06-11T20:47:10.000Z'
                    completed_at: '2026-06-11T20:47:15.000Z'
                    predicted_execution_duration_ms: null
                    predicted_wait_time_ms: null
                    execution_duration_ms: 4200
                    shots: 1000
                    failure: null
                    settings:
                      error_mitigation:
                        debiasing: true
                    stats:
                      qubits: 2
                      circuits: 1
                      gate_counts:
                        1q: 4
                        2q: 1
                    output:
                      compilation: {}
                      error_mitigation:
                        debiasing:
                          variants:
                            - variant_id: 069ce8f8-f437-7d75-8000-9f5f8c3d7897
                              qubit_map:
                                - 4
                                - 12
                                - 7
                              shots: 120
                              results:
                                ionq.result.probabilities.json.v2:
                                  id: 06b27432-cdde-7a0f-8000-1b9e2d6a4f01
                                  format: ionq.result.probabilities.json.v2
                                  media_type: application/json
                                ionq.result.histogram.json.v2:
                                  id: 06b27432-cde0-78a7-8000-9c4f3b1d8e02
                                  format: ionq.result.histogram.json.v2
                                  media_type: application/json
                                ionq.result.shots.json.v2:
                                  id: 06b27432-cde2-7c11-8000-7a6e5d2c9f03
                                  format: ionq.result.shots.json.v2
                                  media_type: application/json
                    results:
                      ionq.result.probabilities.json.v2:
                        id: 3fa85f64-5717-4562-b3fc-2c963f66afa6
                        format: ionq.result.probabilities.json.v2
                        media_type: application/json
                Multi Circuit:
                  value:
                    id: 06a2099c-f700-7000-8000-1111aaaabbbb
                    status: completed
                    type: ionq.multi-circuit.v1
                    backend: qpu.forte-1
                    dry_run: false
                    submitter_id: 64b03577072d45001c85e9c4
                    project_id: 1333d459-cf47-4a5e-acc1-8d4eb4f7b025
                    parent_job_id: null
                    child_job_ids:
                      - 06a2099c-f845-7208-8000-8111ee2dccbc
                      - 06a2099c-f846-7d32-8000-5726853513db
                      - 06a2099c-f848-7811-8000-5c856c7872fc
                    session_id: null
                    metadata: null
                    name: Multi-circuit batch
                    submitted_at: '2026-06-11T20:47:05.440Z'
                    started_at: '2026-06-11T20:47:10.000Z'
                    completed_at: '2026-06-11T20:47:15.000Z'
                    predicted_execution_duration_ms: null
                    predicted_wait_time_ms: null
                    execution_duration_ms: 12500
                    shots: 1000
                    failure: null
                    settings: {}
                    stats:
                      qubits: 2
                      circuits: 3
                      gate_counts:
                        1q: 12
                        2q: 3
                    output: {}
                    results:
                      ionq.result.probabilities-aggregate.json.v1:
                        id: probabilities-aggregate
                        format: ionq.result.probabilities-aggregate.json.v1
                        media_type: application/json
                QAOA Function:
                  value:
                    id: 06a2099c-f700-7000-8000-cccc1234abcd
                    status: completed
                    type: qctrl.qaoa.v1
                    backend: qpu.forte-1
                    dry_run: false
                    submitter_id: 64b03577072d45001c85e9c4
                    project_id: 1333d459-cf47-4a5e-acc1-8d4eb4f7b025
                    parent_job_id: null
                    child_job_ids:
                      - 06a2099c-f845-7208-8000-8111ee2dccbc
                    session_id: null
                    metadata: null
                    name: QAOA maxcut solve
                    submitted_at: '2026-06-11T20:47:05.440Z'
                    started_at: '2026-06-11T20:47:10.000Z'
                    completed_at: '2026-06-11T20:48:30.000Z'
                    predicted_execution_duration_ms: null
                    predicted_wait_time_ms: null
                    execution_duration_ms: 85000
                    shots: 500
                    failure: null
                    settings: {}
                    stats: {}
                    output: {}
                    results:
                      qaoa_results:
                        optimal_cost: -3.5
                        optimal_bitstring: '0101'
                        processing_status: complete
                Quantum Function:
                  value:
                    id: 6e1aabcd-b2ba-4ea5-9fd7-1111ffff2222
                    status: completed
                    type: quantum-function
                    backend: simulator
                    dry_run: false
                    submitter_id: 64b03577072d45001c85e9c4
                    project_id: 1333d459-cf47-4a5e-acc1-8d4eb4f7b025
                    parent_job_id: null
                    child_job_ids: null
                    session_id: null
                    metadata: null
                    name: Hamiltonian energy
                    submitted_at: '2026-06-11T20:47:05.440Z'
                    started_at: '2026-06-11T20:47:10.000Z'
                    completed_at: '2026-06-11T20:48:30.000Z'
                    predicted_execution_duration_ms: null
                    predicted_wait_time_ms: null
                    execution_duration_ms: 60000
                    shots: 1000
                    failure: null
                    settings: {}
                    stats: {}
                    output: {}
                    results:
                      value: -1.1194172043337565
                      variance: 31.20892816209784
        '429':
          description: >-
            Too Many Requests. To get a higher rate limit, please reach out to
            support@ionq.co
        '500':
          description: >-
            A generic server failure, please reach out to support@ionq.co for
            help with this error
        '502':
          description: >-
            Bad Gateway, this can be caused by misbehaving proxies, or by
            service issues. These can be retried, and downtime can be found on
            status.ionq.co
        '503':
          description: >-
            Service Unavailable, this is indicative of service outage, please
            check status.ionq.co
      security:
        - apiKeyAuth: []
      x-codeSamples:
        - lang: curl
          source: >
            curl
            "https://api.ionq.co/v0.4/jobs/617a1f8b-59d4-435d-aa33-695433d7155e"
            \
              -H "Authorization: apiKey your-api-key"
components:
  schemas:
    GetJobResponse:
      anyOf:
        - $ref: '#/components/schemas/SingleCircuitJob'
          title: Single Circuit
        - $ref: '#/components/schemas/MultiCircuitJob'
          title: Multi Circuit
        - $ref: '#/components/schemas/QaoaJob'
          title: QAOA Function
        - $ref: '#/components/schemas/QuantumFunctionJob'
          title: Quantum Function
      description: >-
        Discriminated union over the four job-type families. Tabs in the docs
        are

        grouped by these families (matching the `JobCreationPayload` grouping on
        the

        Create Job endpoint).
    SingleCircuitJob:
      description: >-
        Response shape for single-circuit jobs.


        Covers every circuit-shaped job type: user-submitted (`ionq.circuit.v1`,

        `ionq.qir.v1`) and the per-circuit child jobs spawned by a QAOA run

        (`qctrl.qaoa-circuit.v1`). They all share the same settings, stats,
        output,

        and results shape — only the `type` discriminator differs.
      properties:
        id:
          type: string
        status:
          $ref: '#/components/schemas/JobStatus'
        type:
          type: string
          enum:
            - ionq.circuit.v1
            - ionq.qir.v1
            - qctrl.qaoa-circuit.v1
        backend:
          type: string
        dry_run:
          type: boolean
        submitter_id:
          type: string
          description: The id of the user who submitted the job.
        project_id:
          type: string
          nullable: true
        parent_job_id:
          type: string
          nullable: true
        session_id:
          type: string
          nullable: true
        metadata:
          allOf:
            - $ref: '#/components/schemas/JobMetadata'
          nullable: true
        name:
          type: string
          nullable: true
        submitted_at:
          $ref: '#/components/schemas/IsoTimestamp'
        started_at:
          allOf:
            - $ref: '#/components/schemas/IsoTimestamp'
          nullable: true
        completed_at:
          allOf:
            - $ref: '#/components/schemas/IsoTimestamp'
          nullable: true
        predicted_wait_time_ms:
          type: integer
          format: int32
          nullable: true
        predicted_execution_duration_ms:
          type: integer
          format: int32
          nullable: true
        execution_duration_ms:
          type: integer
          format: int32
          nullable: true
          description: >-
            How long the job actually took to run on the QPU. Null if the job
            hasn't run yet.
        shots:
          type: integer
          format: int32
          description: '`shots` are not included with ideal simulator backend.'
        noise:
          $ref: '#/components/schemas/Noise'
          description: Only present in the response when `backend` is simulator.
        failure:
          allOf:
            - $ref: '#/components/schemas/Failure'
          nullable: true
        cost_model:
          $ref: '#/components/schemas/ApiCostModel'
          description: The billing model used for this job.
        output:
          $ref: '#/components/schemas/CircuitJobOutput'
        settings:
          $ref: '#/components/schemas/CircuitJobSettings'
        stats:
          $ref: '#/components/schemas/CircuitJobStats'
          description: >-
            Job-type-specific execution statistics. The concrete shape is
            determined by the job type (see the per-job-type tabs above).
        results:
          allOf:
            - $ref: '#/components/schemas/CircuitJobResults'
          nullable: true
          description: >-
            Result artifacts produced by the circuit, keyed by format
            identifier. Each entry is an `ArtifactDescriptor` — pass its `id` to
            the [artifact endpoint](/api-reference/v0.4/jobs/get-job-artifact)
            to download the payload. See [Results
            formats](/api-reference/v0.4/schemas/results-formats) for the
            catalog of valid identifiers and their payload schemas.
        child_job_ids:
          items:
            type: string
          type: array
          nullable: true
      required:
        - id
        - status
        - type
        - backend
        - dry_run
        - submitter_id
        - project_id
        - parent_job_id
        - session_id
        - metadata
        - name
        - submitted_at
        - started_at
        - completed_at
        - predicted_wait_time_ms
        - predicted_execution_duration_ms
        - execution_duration_ms
        - failure
        - output
        - settings
        - stats
        - results
        - child_job_ids
      type: object
      additionalProperties: false
    MultiCircuitJob:
      description: >-
        Response shape for `ionq.multi-circuit.v1` jobs. Aggregates results
        across

        the per-circuit child jobs into a single results object keyed by format

        identifier (typically `ionq.result.probabilities-aggregate.json.v1`).
      properties:
        id:
          type: string
        status:
          $ref: '#/components/schemas/JobStatus'
        type:
          type: string
          enum:
            - ionq.multi-circuit.v1
          nullable: false
        backend:
          type: string
        dry_run:
          type: boolean
        submitter_id:
          type: string
          description: The id of the user who submitted the job.
        project_id:
          type: string
          nullable: true
        parent_job_id:
          type: string
          nullable: true
        session_id:
          type: string
          nullable: true
        metadata:
          allOf:
            - $ref: '#/components/schemas/JobMetadata'
          nullable: true
        name:
          type: string
          nullable: true
        submitted_at:
          $ref: '#/components/schemas/IsoTimestamp'
        started_at:
          allOf:
            - $ref: '#/components/schemas/IsoTimestamp'
          nullable: true
        completed_at:
          allOf:
            - $ref: '#/components/schemas/IsoTimestamp'
          nullable: true
        predicted_wait_time_ms:
          type: integer
          format: int32
          nullable: true
        predicted_execution_duration_ms:
          type: integer
          format: int32
          nullable: true
        execution_duration_ms:
          type: integer
          format: int32
          nullable: true
          description: >-
            How long the job actually took to run on the QPU. Null if the job
            hasn't run yet.
        shots:
          type: integer
          format: int32
          description: '`shots` are not included with ideal simulator backend.'
        noise:
          $ref: '#/components/schemas/Noise'
          description: Only present in the response when `backend` is simulator.
        failure:
          allOf:
            - $ref: '#/components/schemas/Failure'
          nullable: true
        cost_model:
          $ref: '#/components/schemas/ApiCostModel'
          description: The billing model used for this job.
        output:
          $ref: '#/components/schemas/CircuitJobOutput'
        settings:
          $ref: '#/components/schemas/CircuitJobSettings'
        stats:
          $ref: '#/components/schemas/CircuitJobStats'
          description: >-
            Job-type-specific execution statistics. The concrete shape is
            determined by the job type (see the per-job-type tabs above).
        results:
          allOf:
            - $ref: '#/components/schemas/MultiCircuitJobResults'
          nullable: true
          description: >-
            Aggregated result artifacts across all child circuits, keyed by
            format identifier. Typically contains
            `ionq.result.probabilities-aggregate.json.v1` — the merged
            probability distribution over every child circuit. Each entry is an
            `ArtifactDescriptor` — pass its `id` to the [artifact
            endpoint](/api-reference/v0.4/jobs/get-job-artifact) to download the
            payload. See [Results
            formats](/api-reference/v0.4/schemas/results-formats) for the
            catalog of valid identifiers and their payload schemas.
        child_job_ids:
          items:
            type: string
          type: array
          nullable: true
      required:
        - id
        - status
        - type
        - backend
        - dry_run
        - submitter_id
        - project_id
        - parent_job_id
        - session_id
        - metadata
        - name
        - submitted_at
        - started_at
        - completed_at
        - predicted_wait_time_ms
        - predicted_execution_duration_ms
        - execution_duration_ms
        - failure
        - output
        - settings
        - stats
        - results
        - child_job_ids
      type: object
      additionalProperties: false
    QaoaJob:
      description: >-
        Response shape for `qctrl.qaoa.v1` jobs — the parent QAOA optimization
        job.

        Its per-iteration child jobs (`qctrl.qaoa-circuit.v1`) are surfaced via

        `child_job_ids` and are documented under the Single Circuit tab.
      properties:
        id:
          type: string
        status:
          $ref: '#/components/schemas/JobStatus'
        type:
          type: string
          enum:
            - qctrl.qaoa.v1
          nullable: false
        backend:
          type: string
        dry_run:
          type: boolean
        submitter_id:
          type: string
          description: The id of the user who submitted the job.
        project_id:
          type: string
          nullable: true
        parent_job_id:
          type: string
          nullable: true
        session_id:
          type: string
          nullable: true
        metadata:
          allOf:
            - $ref: '#/components/schemas/JobMetadata'
          nullable: true
        name:
          type: string
          nullable: true
        submitted_at:
          $ref: '#/components/schemas/IsoTimestamp'
        started_at:
          allOf:
            - $ref: '#/components/schemas/IsoTimestamp'
          nullable: true
        completed_at:
          allOf:
            - $ref: '#/components/schemas/IsoTimestamp'
          nullable: true
        predicted_wait_time_ms:
          type: integer
          format: int32
          nullable: true
        predicted_execution_duration_ms:
          type: integer
          format: int32
          nullable: true
        execution_duration_ms:
          type: integer
          format: int32
          nullable: true
          description: >-
            How long the job actually took to run on the QPU. Null if the job
            hasn't run yet.
        shots:
          type: integer
          format: int32
          description: '`shots` are not included with ideal simulator backend.'
        noise:
          $ref: '#/components/schemas/Noise'
          description: Only present in the response when `backend` is simulator.
        failure:
          allOf:
            - $ref: '#/components/schemas/Failure'
          nullable: true
        cost_model:
          $ref: '#/components/schemas/ApiCostModel'
          description: The billing model used for this job.
        output:
          $ref: '#/components/schemas/QuantumFunctionJobOutput'
        settings:
          $ref: '#/components/schemas/QuantumFunctionJobSettings'
        stats:
          $ref: '#/components/schemas/QuantumFunctionJobStats'
          description: >-
            Job-type-specific execution statistics. The concrete shape is
            determined by the job type (see the per-job-type tabs above).
        results:
          allOf:
            - $ref: '#/components/schemas/QaoaJobResults'
          nullable: true
          description: >-
            Optimization results emitted by the QAOA solver — the best objective
            value, the corresponding bitstring, and the current state of the
            optimization loop. Populated once `processing_status` is `complete`.
        child_job_ids:
          items:
            type: string
          type: array
          nullable: true
      required:
        - id
        - status
        - type
        - backend
        - dry_run
        - submitter_id
        - project_id
        - parent_job_id
        - session_id
        - metadata
        - name
        - submitted_at
        - started_at
        - completed_at
        - predicted_wait_time_ms
        - predicted_execution_duration_ms
        - execution_duration_ms
        - failure
        - output
        - settings
        - stats
        - results
        - child_job_ids
      type: object
      additionalProperties: false
    QuantumFunctionJob:
      description: >-
        Response shape for `quantum-function` jobs. Settings, stats, output, and

        results are all free-form — the concrete shape is defined by the
        function

        implementation and varies by provider.
      properties:
        id:
          type: string
        status:
          $ref: '#/components/schemas/JobStatus'
        type:
          type: string
          enum:
            - quantum-function
          nullable: false
        backend:
          type: string
        dry_run:
          type: boolean
        submitter_id:
          type: string
          description: The id of the user who submitted the job.
        project_id:
          type: string
          nullable: true
        parent_job_id:
          type: string
          nullable: true
        session_id:
          type: string
          nullable: true
        metadata:
          allOf:
            - $ref: '#/components/schemas/JobMetadata'
          nullable: true
        name:
          type: string
          nullable: true
        submitted_at:
          $ref: '#/components/schemas/IsoTimestamp'
        started_at:
          allOf:
            - $ref: '#/components/schemas/IsoTimestamp'
          nullable: true
        completed_at:
          allOf:
            - $ref: '#/components/schemas/IsoTimestamp'
          nullable: true
        predicted_wait_time_ms:
          type: integer
          format: int32
          nullable: true
        predicted_execution_duration_ms:
          type: integer
          format: int32
          nullable: true
        execution_duration_ms:
          type: integer
          format: int32
          nullable: true
          description: >-
            How long the job actually took to run on the QPU. Null if the job
            hasn't run yet.
        shots:
          type: integer
          format: int32
          description: '`shots` are not included with ideal simulator backend.'
        noise:
          $ref: '#/components/schemas/Noise'
          description: Only present in the response when `backend` is simulator.
        failure:
          allOf:
            - $ref: '#/components/schemas/Failure'
          nullable: true
        cost_model:
          $ref: '#/components/schemas/ApiCostModel'
          description: The billing model used for this job.
        output:
          $ref: '#/components/schemas/QuantumFunctionJobOutput'
        settings:
          $ref: '#/components/schemas/QuantumFunctionJobSettings'
        stats:
          $ref: '#/components/schemas/QuantumFunctionJobStats'
          description: >-
            Job-type-specific execution statistics. The concrete shape is
            determined by the job type (see the per-job-type tabs above).
        results:
          allOf:
            - $ref: '#/components/schemas/QuantumFunctionJobResults'
          nullable: true
          description: >-
            Scalar metrics emitted by the quantum-function implementation — the
            expectation value of the observable (`value`) and its estimated
            variance across the shot ensemble (`variance`).
        child_job_ids:
          items:
            type: string
          type: array
          nullable: true
      required:
        - id
        - status
        - type
        - backend
        - dry_run
        - submitter_id
        - project_id
        - parent_job_id
        - session_id
        - metadata
        - name
        - submitted_at
        - started_at
        - completed_at
        - predicted_wait_time_ms
        - predicted_execution_duration_ms
        - execution_duration_ms
        - failure
        - output
        - settings
        - stats
        - results
        - child_job_ids
      type: object
      additionalProperties: false
    JobStatus:
      type: string
      enum:
        - submitted
        - ready
        - started
        - canceled
        - failed
        - completed
    JobMetadata:
      properties: {}
      type: object
      additionalProperties:
        type: string
    IsoTimestamp:
      type: string
    Noise:
      properties:
        model:
          $ref: '#/components/schemas/NoiseModel'
        seed:
          type: integer
          format: int32
      required:
        - model
      type: object
      additionalProperties: false
    Failure:
      properties:
        code:
          type: string
          enum:
            - InvalidInput
            - CompilationError
            - ContractExpiredError
            - DebiasingError
            - InternalError
            - NotEnoughQubits
            - OptimizationError
            - PreflightError
            - QuantumCircuitComplexityError
            - QuantumComputerError
            - QuotaExhaustedError
            - SimulationError
            - SimulationTimeout
            - SystemCancel
            - TooLongPredictedExecutionTime
            - TooManyControls
            - TooManyGates
            - TooManyShots
            - UnknownBillingError
            - UnsupportedGate
        message:
          type: string
      required:
        - code
        - message
      type: object
      additionalProperties: false
    ApiCostModel:
      type: string
      enum:
        - QCT
        - 2QGE_operations
      description: >-
        The billing model used for this job. `QCT` for jobs billed on quantum

        compute time, `2QGE_operations` for jobs billed on two-qubit gate
        operations.
    CircuitJobOutput:
      properties:
        compilation:
          $ref: '#/components/schemas/CompilationOutput'
        error_mitigation:
          $ref: '#/components/schemas/ErrorMitigationOutput'
      type: object
      additionalProperties: {}
    CircuitJobSettings:
      properties:
        compilation:
          $ref: '#/components/schemas/CircuitJobCompilationSettings'
        error_mitigation:
          $ref: '#/components/schemas/CircuitJobErrorMitigationSettings'
      type: object
      additionalProperties: false
    CircuitJobStats:
      properties:
        qubits:
          type: integer
          format: int32
        circuits:
          type: integer
          format: int32
        gate_counts:
          $ref: '#/components/schemas/NumberMap'
        kwh:
          type: number
          format: double
        predicted_quantum_compute_time_us:
          type: integer
          format: int32
        billed_quantum_compute_time_us:
          type: integer
          format: int32
      type: object
      additionalProperties: false
    CircuitJobResults:
      description: >-
        Results object for circuit-family jobs (single-circuit, qasm, qasm3,
        qir, qaoa-circuit).

        Each entry is keyed by an artifact format identifier. See the [Results
        formats](/api-reference/v0.4/schemas/results-formats) page for the
        catalog of valid identifiers.
      properties: {}
      type: object
      additionalProperties:
        $ref: '#/components/schemas/ArtifactDescriptor'
    MultiCircuitJobResults:
      description: >-
        Results object for ionq.multi-circuit.v1 jobs. Keyed by artifact format
        identifier;

        `ionq.result.probabilities-aggregate.json.v1` is the aggregated
        distribution across all circuits. See the [Results
        formats](/api-reference/v0.4/schemas/results-formats) page for the full
        list of valid identifiers.
      properties: {}
      type: object
      additionalProperties:
        $ref: '#/components/schemas/ArtifactDescriptor'
    QuantumFunctionJobOutput:
      description: >-
        Output for quantum-function jobs. Shape varies by function
        implementation.
      properties: {}
      type: object
      additionalProperties: {}
    QuantumFunctionJobSettings:
      description: >-
        Settings for quantum-function-family jobs (`qctrl.qaoa.v1`,
        `quantum-function`).

        Unlike circuit jobs, no compilation settings are accepted — only error
        mitigation.
      properties:
        error_mitigation:
          $ref: '#/components/schemas/CircuitJobErrorMitigationSettings'
      type: object
      additionalProperties: false
    QuantumFunctionJobStats:
      description: >-
        Stats for quantum-function jobs. Shape varies by function
        implementation.
      properties: {}
      type: object
      additionalProperties: {}
    QaoaJobResults:
      description: Results for `qctrl.qaoa.v1` jobs.
      properties:
        qaoa_results:
          $ref: '#/components/schemas/QaoaResults'
      type: object
      additionalProperties: false
    QuantumFunctionJobResults:
      description: >-
        Results for quantum-function jobs — a scalar estimator output (`value`)
        and

        its estimated variance across the shot ensemble (`variance`).
      properties:
        value:
          type: number
          format: double
          description: >-
            Scalar value produced by the function — typically the expectation
            value of the observable.
        variance:
          type: number
          format: double
          description: Estimated variance of `value` across the shot ensemble.
      type: object
      additionalProperties: false
    NoiseModel:
      type: string
      description: >-
        Available options: `ideal`, `harmony`, `harmony-1`, `harmony-2`,
        `aria-1`, `aria-2`, `forte-1`, `forte-enterprise-1`
    CompilationOutput:
      properties:
        compiled_circuits:
          $ref: '#/components/schemas/CompiledCircuits'
      type: object
      additionalProperties: false
    ErrorMitigationOutput:
      properties:
        debiasing:
          properties:
            variants:
              items:
                $ref: '#/components/schemas/VariantInfo'
              type: array
            aggregation_method:
              type: string
          type: object
        symmetry_verification:
          properties:
            num_allowed_states:
              type: number
              format: double
            applied:
              type: boolean
          type: object
          nullable: true
        aggregations:
          $ref: '#/components/schemas/AggregationsOutput'
      type: object
      additionalProperties: false
    CircuitJobCompilationSettings:
      properties:
        precision:
          type: string
        opt:
          type: number
          format: double
        gate_basis:
          type: string
        service_version:
          type: string
      type: object
      additionalProperties: false
    CircuitJobErrorMitigationSettings:
      properties:
        debiasing:
          type: boolean
        symmetry_verification:
          type: boolean
      type: object
      additionalProperties: false
    NumberMap:
      properties: {}
      type: object
      additionalProperties:
        type: number
        format: double
    ArtifactDescriptor:
      description: >-
        Artifact descriptor. Pass `id` to `GET
        /v0.4/jobs/{id}/artifacts/{artifactId}` to

        download the artifact payload, then validate it against the JSON Schema
        for its format.
      properties:
        id:
          type: string
          description: Artifact ID used to download via the artifacts endpoint.
        format:
          type: string
          description: >-
            Format identifier. Fetch the payload schema from the matching
            schema-catalog endpoint.
        media_type:
          type: string
      required:
        - id
        - format
        - media_type
      type: object
      additionalProperties: false
    QaoaResults:
      description: Optimization output recorded by a Q-CTRL QAOA job after it completes.
      properties:
        optimal_cost:
          type: number
          format: double
          description: Best objective value the optimizer reached.
        optimal_bitstring:
          type: string
          description: Bitstring corresponding to the best solution found.
        processing_status:
          type: string
          enum:
            - running
            - complete
            - max_iteration
          description: Current state of the optimization loop.
      required:
        - optimal_cost
        - optimal_bitstring
        - processing_status
      type: object
      additionalProperties: false
    CompiledCircuits:
      description: >-
        Map of compiled-circuit artifacts keyed by circuit format identifier

        (e.g. `ionq.native.v1`). See the [Circuit
        formats](/api-reference/v0.4/schemas/circuit-formats) page for the
        catalog of valid identifiers.
      properties: {}
      type: object
      additionalProperties:
        $ref: '#/components/schemas/ArtifactDescriptor'
    VariantInfo:
      properties:
        variant_id:
          type: string
        qubit_map:
          items:
            type: number
            format: double
          type: array
          nullable: true
        shots:
          type: integer
          format: int32
        results:
          $ref: '#/components/schemas/VariantResults'
      required:
        - variant_id
        - qubit_map
        - shots
      type: object
      additionalProperties: false
    AggregationsOutput:
      properties:
        average:
          $ref: '#/components/schemas/AggregationArtifactDescriptor'
        voting:
          $ref: '#/components/schemas/AggregationArtifactDescriptor'
        dnl:
          $ref: '#/components/schemas/AggregationArtifactDescriptor'
        majority:
          $ref: '#/components/schemas/AggregationArtifactDescriptor'
      type: object
      additionalProperties: false
    VariantResults:
      description: >-
        Per-variant results object. Each entry is keyed by an artifact format

        identifier; pass the descriptor's `id` to `GET
        /v0.4/jobs/{id}/artifacts/{artifactId}`

        to download the payload, then validate it against the JSON Schema for
        its format.

        See the [Results formats](/api-reference/v0.4/schemas/results-formats)
        page for

        the catalog of valid identifiers.
      properties: {}
      type: object
      additionalProperties:
        $ref: '#/components/schemas/ArtifactDescriptor'
    AggregationArtifactDescriptor:
      properties:
        id:
          type: string
        format:
          $ref: '#/components/schemas/ResultFormat.ProbabilitiesV2'
        media_type:
          type: string
      required:
        - id
        - format
        - media_type
      type: object
      additionalProperties: false
    ResultFormat.ProbabilitiesV2:
      enum:
        - ionq.result.probabilities.json.v2
      type: string
  securitySchemes:
    apiKeyAuth:
      description: >-
        API keys are associated with a user and can be created on the [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`
      in: header
      name: Authorization
      type: apiKey

````