---
title: "GET /schemas/formats/{format}"
method: GET
path: "/schemas/formats/{format}"
tags: ["Schemas"]
---

# GET /schemas/formats/{format}

`GET /schemas/formats/{format}`

Returns the JSON Schema document for the requested artifact format.
See the Results formats and Circuit formats catalog pages for the full list of identifiers and their payload schemas.

## Path parameters

- `format` 'ionq.result.probabilities.json.v1' | 'ionq.result.probabilities.json.v2' | 'ionq.result.histogram.json.v1' | 'ionq.result.histogram.json.v2' | 'ionq.result.shots.json.v1' | 'ionq.result.shots.json.v2' | 'ionq.result.probabilities-aggregate.json.v1' | 'ionq.native.v1', required

## Response `200`

Ok

- FormatSchemaDocument — JSON Schema document returned by the schemas endpoint. The exact contents vary by format identifier (see the Results / Circuit formats catalog pages for each format's structure).
  - `$schema` string, required — JSON Schema draft URI.
  - `$id` string, required — Format identifier (matches the path parameter).
  - `type` string, required — Top-level JSON type of the format payload.
  - `description` string — Human-readable description of the format.

---

[API](https://skmtc.net/ionq/apis/ionq-cloud-platform-api.md) · [All operations](https://skmtc.net/ionq/apis/ionq-cloud-platform-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/ionq/ionq-cloud-platform-api/versions/0410071e1cd0/schema)