Skip to main content
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.

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.

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.

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.

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.

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.

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