Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

ibm-quantum Instances API

The Instances API from ibm-quantum — 3 operation(s) for instances.

ibm-quantum Instances API is one of 11 APIs that ibm-quantum publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

This API exposes 3 JSON Schema definitions.

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

This API exposes 4 operations across 3 paths, and defines 8 schemas. It is described by OpenAPI 3.0.0, at version 0.45.3.

Requests are made against 2 base URLs: https://quantum.cloud.ibm.com/api, https://eu-de.quantum.cloud.ibm.com/api.

4 operations 3 paths 8 schemas 3 GET1 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.0.0
API Version
0.45.3
Servers
https://quantum.cloud.ibm.com/api
https://eu-de.quantum.cloud.ibm.com/api
Authentication
HTTP Bearer, API Key, API Key
License
Resource Areas
1

Authentication & Security 3

ibm-quantum Instances API declares 3 security schemes for authenticating requests. It accepts HTTP bearer tokens (BearerAuth). An API key is passed in the header as Service-CRN (ServiceCRN). An API key is passed in the header as IBM-API-Version (ApiVersion). By default, every request must be authenticated.

  • BearerAuth — IBM Cloud IAM bearer token
  • ServiceCRN — IBM Cloud Service CRN identifying the Qiskit Runtime instance
  • ApiVersion — API version, e.g. 2026-03-15

Paths & Operations 4

Across 3 paths, the API surfaces 4 operations — 3 GET, 1 PUT. Each is listed below with its method, path, parameters, and response codes.

Instances 4
GET
/v1/instance
Get Current Instance Details
get_instance 1 param → 200401403404
GET
/v1/instances/configuration
Get Instance Configuration
get_instance_configuration 1 param → 200401403404
PUT
/v1/instances/configuration
Update Instance Configuration
replace_instance_configuration 1 param body → 204400401403404409
GET
/v1/instances/usage
Get Instance Usage
get_usage 1 param → 200401

Schemas 8

The contract defines 8 schemas that model the data the API accepts and returns. The most detailed are GetUsageResponse (7 properties), Instance (5 properties), GenericError (4 properties), ErrorContainer (2 properties). Each schema is shown below with its type and property counts.

ErrorContainer
object
Error response
2 properties
InstanceConfiguration
object
Instance configuration
1 property
GenericErrorDto
object
2 properties 2 required
InstanceConfigurationUpdate
object
instance configuration update
1 property
GenericError
object
4 properties 4 required
UsagePeriod
object
2 properties
GetUsageResponse
object
7 properties 3 required
Instance
object
Instance
5 properties

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

ibm-quantum-instances-api-openapi.yml Raw ↑

Other APIs ibm-quantum publishes across the network.

Qiskit Functions Catalog API
Qiskit Transpiler as a Service API
ibm-quantum Accounts API
ibm-quantum Analytics API
ibm-quantum Backends API
ibm-quantum Jobs API
ibm-quantum Sessions API
ibm-quantum Tags API
ibm-quantum Versions API
ibm-quantum Workloads API