How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

IonQ Jobs API

The Jobs API from IonQ — 11 operation(s) for jobs.

IonQ Jobs API is one of 7 APIs that IonQ publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 3 JSON Schema definitions.

Tagged areas include Job. The published artifact set on APIs.io includes an OpenAPI specification, API documentation, a JSON-LD context, and 3 JSON Schemas.

This API exposes 14 operations across 11 paths, and defines 54 schemas. It is described by OpenAPI 3.2.0, at version v0.4.

Requests are made against a single base URL, https://api.ionq.co/v0.4.

14 operations 11 paths 54 schemas 2 DELETE9 GET1 POST2 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
v0.4
Base URL
https://api.ionq.co/v0.4
Authentication
API Key
Contact
Resource Areas
1

Authentication & Security 1

IonQ Jobs API declares 1 security scheme for authenticating requests. An API key is passed in the header as Authorization (apiKeyAuth).

  • apiKeyAuth — 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 wi…

Paths & Operations 14

Across 11 paths, the API surfaces 14 operations — 2 DELETE, 9 GET, 1 POST, 2 PUT. Each is listed below with its method, path, parameters, and response codes.

Jobs 14
POST
/jobs
Create job
CreateJob body → 201429500502503
GET
/jobs
Get jobs
GetJobs 8 params → 200429500502503
DELETE
/jobs
Delete jobs
DeleteJobs body → 200429500502503
GET
/jobs/{UUID}
Get job
GetJob 1 param → 200429500502503
DELETE
/jobs/{UUID}
Delete job
DeleteJob 1 param → 200429500502503
GET
/jobs/{UUID}/cost
Get job cost
GetJobCost 1 param → 200429500502503
GET
/jobs/{UUID}/circuits/{lang}
Get compiled file
GetCompiledFile 2 params → 200403404429500502503
PUT
/jobs/{UUID}/status/cancel
Cancel a job
CancelJob 1 param → 200429500502503
PUT
/jobs/status/cancel
Cancel jobs
CancelJobs body → 200429500502503
GET
/jobs/estimate
Estimate job cost
EstimateJobCost 7 params → 200429500502503
GET
/jobs/{UUID}/results/probabilities
Fetch the probability distribution for a completed job
GetJobProbabilities 2 params → 200404
GET
/jobs/{UUID}/variants/{variantId}/results/probabilities
Get variant probabilities
GetVariantProbabilities 2 params → 200404
GET
/jobs/{UUID}/variants/{variantId}/results/histogram
Get variant histogram
GetVariantHistogram 2 params → 200404
GET
/jobs/{UUID}/variants/{variantId}/results/shots
Get variant shots
GetVariantShots 2 params → 200404

Schemas 54

The contract defines 54 schemas that model the data the API accepts and returns. The most detailed are GetCircuitJobResponse (26 properties), BaseJob (25 properties), QctrlQaoaJobCreationPayload (10 properties), CircuitJobCreationPayload (10 properties). Each schema is shown below with its type and property counts.

NativeGate
string
HamiltonianPauliTerm
object
2 properties 2 required
Noise
object
2 properties 1 required
QuadraticConstraint
object
A class to model quadratic inequality constraints of the form .. math:: x^T P x + r^T x \leq c.
3 properties 3 required
Registers
object
HamiltonianEnergyInput
object
2 properties 1 required
Failure
object
2 properties 2 required
QISCircuit
object
5 properties 1 required
Ansatz
object
1 property 1 required
MultiCircuitJobCreationPayload
object
Submit multiple circuits in a single job. Each circuit inherits the parent input.gateset unless overridden by circuits[].gateset.
10 properties 3 required
JobStatus
string
JsonObject
object
NoiseModel
string
JobCreationPayload
JobCreationResponse
object
3 properties 3 required
CircuitJobSettings
object
2 properties
JobsCanceledResponse
object
2 properties 2 required
JsonCircuitInput
LinearConstraint
object
A class to model linear inequality constraints of the form .. math:: A x \leq b.
2 properties 2 required
GetJobCostResponse
object
3 properties 2 required
CostModel
string
JobsDeletedResponse
object
2 properties 2 required
GetCircuitJobResponse
object
26 properties 23 required
QisCircuitInput
object
3 properties 2 required
CircuitJobResult
object
3 properties
GetVariantResultsResponse
object
GetJobResponse
CircuitJobCompilationSettings
object
4 properties
JobBackends
string
Available options: simulator, qpu.aria-1, qpu.aria-2, qpu.forte-1, qpu.forte-enterprise-1
NativeCircuit
object
5 properties 1 required
JobMetadata
object
NumberMap
object
Gate_NativeGate
object
8 properties 1 required
JobCanceledResponse
object
2 properties 2 required
QctrlQaoaJobCreationPayload
object
Submit a combinatorial optimization job to solve a maxcut problem using Q-CTRL's QAOA Solver. See our QAOA Job guide for more infromation.
10 properties 4 required
JsonMultiCircuitInput
object
3 properties 2 required
JobsBulkOperationRequest
object
1 property 1 required
IsoTimestamp
string
HamiltonianEnergyData
object
6 properties 2 required
GetJobEstimateResponse
object
7 properties 7 required
NativeCircuitInput
object
3 properties 2 required
CircuitJobCreationPayload
object
10 properties 3 required
JobDeletedResponse
object
2 properties 2 required
GetResultsResponse
object
Gate_QisGate
object
6 properties 1 required
QisGate
string
CircuitJobStats
object
6 properties
QuantumFunctionInput
QctrlQaoaJobInput
object
2 properties 2 required
QuantumFunctionJobCreationPayload
object
9 properties 3 required
GenericQuantumFunctionInput
object
3 properties 2 required
GetJobsResponse
object
2 properties 2 required
BaseJob
object
25 properties 22 required
GetJobEstimateQueryParams
object
7 properties 1 required

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

ionq-jobs-api-openapi.yml Raw ↑

Other APIs IonQ publishes across the network.

IonQ Quantum Cloud API (v0.3 Legacy)
IonQ Backends API
IonQ Characterizations API
IonQ Sessions API
IonQ Usage API
IonQ Whoami API
Where this information came from

This is an independent, third-party profile of IonQ Jobs API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.