> ## 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](/user-manual/jobs#viewing-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: April 30, 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:
                Example 1:
                  value:
                    id: e1a09d90-b2ba-4ea5-9fd7-4bfc14eac524
                    status: completed
                    type: ionq.circuit.v1
                    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: null
                    submitted_at: '2025-05-28T20:47:05.440Z'
                    started_at: null
                    completed_at: null
                    predicted_execution_duration_ms: null
                    predicted_wait_time_ms: null
                    execution_duration_ms: null
                    shots: 1000
                    noise:
                      model: ideal
                    failure: null
                    settings:
                      compilation: {}
                    stats:
                      qubits: 20
                      circuits: 1
                      gate_counts:
                        1q: 1028
                        2q: 110
                      predicted_quantum_compute_time_us: 5000
                      billed_quantum_compute_time_us: 5200
                    results:
                      probabilities:
                        url: >-
                          /v0.4/jobs/e1a09d90-b2ba-4ea5-9fd7-4bfc14eac524/results/probabilities
                    output:
                      compilation: {}
                      error_mitigation:
                        debiasing:
                          variants:
                            - variant_id: 069ce8f8-f437-7d75-8000-9f5f8c3d7897
                              qubit_map:
                                - 4
                                - 12
                                - 7
                              shots: 120
                              results:
                                probabilities:
                                  url: >-
                                    /v0.4/jobs/e1a09d90-b2ba-4ea5-9fd7-4bfc14eac524/variants/069ce8f8-f437-7d75-8000-9f5f8c3d7897/results/probabilities
                                histogram:
                                  url: >-
                                    /v0.4/jobs/e1a09d90-b2ba-4ea5-9fd7-4bfc14eac524/variants/069ce8f8-f437-7d75-8000-9f5f8c3d7897/results/histogram
                                shots:
                                  url: >-
                                    /v0.4/jobs/e1a09d90-b2ba-4ea5-9fd7-4bfc14eac524/variants/069ce8f8-f437-7d75-8000-9f5f8c3d7897/results/shots
        '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:
      $ref: '#/components/schemas/GetCircuitJobResponse'
    GetCircuitJobResponse:
      properties:
        id:
          type: string
        status:
          $ref: '#/components/schemas/JobStatus'
        type:
          type: string
        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
        noise:
          $ref: '#/components/schemas/Noise'
          description: Only present in the response when `backend` is simulator.
        failure:
          allOf:
            - $ref: '#/components/schemas/Failure'
          nullable: true
        output:
          $ref: '#/components/schemas/JsonObject'
        settings:
          $ref: '#/components/schemas/CircuitJobSettings'
        stats:
          $ref: '#/components/schemas/CircuitJobStats'
        results:
          allOf:
            - $ref: '#/components/schemas/CircuitJobResult'
          nullable: true
        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
    JsonObject:
      properties: {}
      type: object
      additionalProperties: {}
    CircuitJobSettings:
      properties:
        compilation:
          $ref: '#/components/schemas/CircuitJobCompilationSettings'
        error_mitigation:
          properties:
            debiasing:
              anyOf:
                - properties:
                    phi_chi_twirling:
                      properties:
                        p2q:
                          type: number
                          format: double
                        t2q:
                          type: number
                          format: double
                        t1q:
                          type: number
                          format: double
                      type: object
                  type: object
                - type: boolean
          type: object
      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
    CircuitJobResult:
      properties:
        probabilities:
          properties:
            url:
              type: string
          required:
            - url
          type: object
        histogram:
          properties:
            url:
              type: string
          required:
            - url
          type: object
        shots:
          properties:
            url:
              type: string
          required:
            - url
          type: object
      type: object
      additionalProperties: false
    NoiseModel:
      type: string
      enum:
        - ideal
        - harmony
        - harmony-1
        - harmony-2
        - aria-1
        - aria-2
        - forte-1
        - forte-enterprise-1
    CircuitJobCompilationSettings:
      properties:
        precision:
          type: string
        opt:
          type: number
          format: double
        gate_basis:
          type: string
        service_version:
          type: string
      type: object
      additionalProperties: false
    NumberMap:
      properties: {}
      type: object
      additionalProperties:
        type: number
        format: double
  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

````