Results formats

{
  "ionq.result.probabilities.json.v1": {
    "0": 0.5,
    "1": 0.25,
    "3": 0.25
  },
  "ionq.result.probabilities.json.v2": {
    "probabilities": {
      "registers": {
        "output_all": {
          "11": 0.5,
          "00": 0.5
        }
      }
    }
  },
  "ionq.result.histogram.json.v1": {
    "0": 500,
    "1": 250,
    "3": 250
  },
  "ionq.result.histogram.json.v2": {
    "histogram": {
      "registers": {
        "output_all": {
          "11": 500,
          "00": 500
        }
      }
    }
  },
  "ionq.result.shots.json.v1": [
    "2",
    "1",
    "3",
    "0"
  ],
  "ionq.result.shots.json.v2": {
    "shots": [
      {
        "registers": {
          "output_all": [
            1,
            0
          ]
        }
      },
      {
        "registers": {
          "output_all": [
            0,
            1
          ]
        }
      }
    ]
  },
  "ionq.result.probabilities-aggregate.json.v1": {
    "06a2099c-f845-7208-8000-8111ee2dccbc": {
      "2": 1
    },
    "06a2099c-f846-7d32-8000-5726853513db": {
      "0": 0.5,
      "1": 0.5
    }
  }
}

When a job completes, its results object contains one entry per available result artifact, keyed by format identifier. Each entry is an ArtifactDescriptor — pass the descriptor’s id to the artifact endpoint to download the payload. To fetch the JSON Schema for a format, call GET /v0.4/schemas/formats/{format} with the identifier.

Catalog of supported result artifact formats. Each property below documents one format's payload structure. Used by the Results formats docs page.

ionq.result.probabilities.json.v1

object

required

ionq.result.probabilities.json.v1 — Legacy probability distribution. Flat object keyed by decimal qubit state integer strings, values are probabilities summing to 1.

Show child attributes

Example:

{ "0": 0.5, "1": 0.25, "3": 0.25 }

ionq.result.probabilities.json.v2

object

required

ionq.result.probabilities.json.v2 — Register-nested probability distribution. Each register maps zero-padded bitstrings to probabilities summing to 1 within the register.

Show child attributes

Example:

{
  "probabilities": {
    "registers": { "output_all": { "11": 0.5, "00": 0.5 } }
  }
}

ionq.result.histogram.json.v1

object

required

ionq.result.histogram.json.v1 — Legacy shot count histogram. Flat object keyed by decimal qubit state integer strings, values are shot counts.

Show child attributes

Example:

{ "0": 500, "1": 250, "3": 250 }

ionq.result.histogram.json.v2

object

required

ionq.result.histogram.json.v2 — Register-nested shot count histogram. Each register maps zero-padded bitstrings to shot counts.

Show child attributes

Example:

{
  "histogram": {
    "registers": { "output_all": { "11": 500, "00": 500 } }
  }
}

ionq.result.shots.json.v1

string[]

required

ionq.result.shots.json.v1 — Legacy per-shot outcomes. Array of decimal qubit state integer strings, one element per shot.

Example:

["2", "1", "3", "0"]

ionq.result.shots.json.v2

object

required

ionq.result.shots.json.v2 — Per-shot register outcomes. Each shot records measured bit arrays for every named register.

Show child attributes

Example:

{
  "shots": [
    { "registers": { "output_all": [1, 0] } },
    { "registers": { "output_all": [0, 1] } }
  ]
}

ionq.result.probabilities-aggregate.json.v1

object

required

ionq.result.probabilities-aggregate.json.v1 — Aggregated probability distributions across all circuits in an ionq.multi-circuit.v1 job. Top-level keys are child job UUIDs; each value is that child's probability distribution.

Show child attributes

Example:

{
  "06a2099c-f845-7208-8000-8111ee2dccbc": { "2": 1 },
  "06a2099c-f846-7d32-8000-5726853513db": { "0": 0.5, "1": 0.5 }
}

Get format schema Circuit formats

⌘I

IonQ v0.4 API

Jobs

Sessions

Backends

Utilities

Schemas