Qiskit Runtime Backends API

openapi: 3.0.0
info:
  title: Qiskit Runtime Backends API
  version: 0.45.3
  description: Discover and inspect available IBM Quantum backends (QPUs and simulators). Returns backend list, properties (calibrations), configuration, defaults, and live status.
  contact:
    name: IBM Quantum
    url: https://quantum.cloud.ibm.com
  license:
    name: IBM
    url: https://www.ibm.com/legal
servers:
- url: https://quantum.cloud.ibm.com/api
  description: Global region
- url: https://eu-de.quantum.cloud.ibm.com/api
  description: EU-DE region
tags:
- name: Backends
paths:
  /v1/backends:
    get:
      tags:
      - Backends
      summary: List Your Backends
      operationId: list_backends
      parameters:
      - in: query
        name: fields
        required: false
        schema:
          description: A comma-separated list of fields to return in the response. Initially only supports conditionally returning the `wait_time_seconds` property.
          type: string
          enum:
          - wait_time_seconds
          default: ''
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BackendsResponse'
              examples:
                sampleBackendsResponse:
                  $ref: '#/components/examples/backendsResponseExample'
      description: 'Returns a list of all the backends your service instance has access to.

        '
      security:
      - IBMCloudAPIKey: []
      - ServiceCRN: []
      - IBMCloudAuth: []
      x-ibm-events:
        events:
        - name: quantum-computing.device.read
      x-ibm-permissions:
        actions:
        - name: quantum-computing.device.read
    parameters:
    - $ref: '#/components/parameters/IBM-API-Version'
  /v1/backends/{id}/properties:
    get:
      tags:
      - Backends
      summary: Get Backend Properties
      operationId: get_backend_properties
      parameters:
      - schema:
          type: string
          pattern: ^.*$
          minLength: 1
          maxLength: 500
        name: id
        description: Identifier of an available backend
        in: path
        required: true
      - in: query
        name: updated_before
        required: false
        schema:
          type: string
          format: date-time
          minLength: 1
          maxLength: 100
        description: Returns properties with last_update_date before the given time.
      - in: query
        name: calibration_id
        required: false
        schema:
          type: string
          pattern: ^.*$
          minLength: 1
          maxLength: 100
        description: Returns properties associated with the given calibration ID.
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BackendPropertiesResponse'
              examples:
                sampleBackendPropertiesResponse:
                  $ref: '#/components/examples/sampleBackendPropertiesResponse'
      description: Returns the properties for the specified backend. Simulator backends may not support this.
      security:
      - IBMCloudAPIKey: []
      - ServiceCRN: []
      - IBMCloudAuth: []
      x-ibm-events:
        events:
        - name: quantum-computing.device.read
      x-ibm-permissions:
        actions:
        - name: quantum-computing.device.read
    parameters:
    - $ref: '#/components/parameters/IBM-API-Version'
  /v1/backends/{id}/configuration:
    get:
      tags:
      - Backends
      summary: Get Backend Configuration
      operationId: get_backend_configuration
      parameters:
      - schema:
          type: string
          pattern: ^.*$
          minLength: 1
          maxLength: 500
        name: id
        description: Identifier of an available backend
        in: path
        required: true
      - in: query
        name: calibration_id
        required: false
        schema:
          type: string
          pattern: ^.*$
          minLength: 1
          maxLength: 100
        description: Returns configuration associated with the given calibration ID.
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BackendConfigurationResponse'
              examples:
                sampleBackendConfigurationResponse:
                  $ref: '#/components/examples/sampleBackendConfigurationResponse'
      description: Returns the configuration for the specified backend.
      security:
      - IBMCloudAPIKey: []
      - ServiceCRN: []
      - IBMCloudAuth: []
      x-ibm-events:
        events:
        - name: quantum-computing.device.read
      x-ibm-permissions:
        actions:
        - name: quantum-computing.device.read
    parameters:
    - $ref: '#/components/parameters/IBM-API-Version'
  /v1/backends/{id}/status:
    get:
      tags:
      - Backends
      summary: Get Backend Status
      operationId: get_backend_status
      parameters:
      - schema:
          type: string
          pattern: ^.*$
          minLength: 1
          maxLength: 500
        name: id
        description: Identifier of an available backend
        in: path
        required: true
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BackendStatusResponse'
              examples:
                sampleBackendStatusResponse:
                  $ref: '#/components/examples/sampleBackendStatusResponse'
      description: Returns the status for the specified backend ID.
      security:
      - IBMCloudAPIKey: []
      - ServiceCRN: []
      - IBMCloudAuth: []
      x-ibm-events:
        events:
        - name: quantum-computing.device.read
      x-ibm-permissions:
        actions:
        - name: quantum-computing.device.read
    parameters:
    - $ref: '#/components/parameters/IBM-API-Version'
  /v1/backends/{id}/defaults:
    get:
      tags:
      - Backends
      summary: Get Backend Default Settings
      operationId: get_backend_defaults
      parameters:
      - schema:
          type: string
          pattern: ^.*$
          minLength: 1
          maxLength: 500
        name: id
        description: Identifier of an available backend
        in: path
        required: true
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BackendDefaultsResponse'
              examples:
                sampleBackendDefaultsResponse:
                  $ref: '#/components/examples/sampleBackendDefaultsResponse'
      description: Returns the defaults for the specified backend. Simulator backends may not support this.
      security:
      - IBMCloudAPIKey: []
      - ServiceCRN: []
      - IBMCloudAuth: []
      x-ibm-events:
        events:
        - name: quantum-computing.device.read
      x-ibm-permissions:
        actions:
        - name: quantum-computing.device.read
    parameters:
    - $ref: '#/components/parameters/IBM-API-Version'
components:
  schemas:
    BackendConfigurationResponse:
      title: BackendsConfigurationResponse
      type: object
      description: Backends Configuration Response
      required:
      - backend_name
      - backend_version
      - basis_gates
      - conditional
      - coords
      - coupling_map
      - gates
      - local
      - memory
      - n_qubits
      - online_date
      - u_channel_lo
      properties:
        acquisition_latency:
          description: Array of dimension n_qubits x n_registers. Latency (in units of dt) to write a measurement result from qubit n into register slot m.
          minItems: 1
          maxItems: 2147483647
          items:
            type: array
          example:
          - - 0
            - 1
          - - 1
            - 0
          type: array
        backend_name:
          type: string
          description: Backend name
          pattern: ^[a-zA-Z0-9_]*$
          minLength: 1
          maxLength: 64
          example: ibmq_eagle
        backend_version:
          type: string
          description: Backend version in the form X.X.X
          pattern: ^[0-9]+\.[0-9]+\.[0-9]+$
          minLength: 5
          maxLength: 16
          example: 1.6.0
        basis_gates:
          description: List of basis gate names on the backend
          minItems: 1
          maxItems: 64
          example:
          - u1
          - cx
          - h
          items:
            type: string
          type: array
        clops:
          description: Circuit layer operations per second (CLOPS). A measure of how many layers of a 100x100 hardware-aware circuit a QPU can execute per second.
          allOf:
          - $ref: '#/components/schemas/ClopsType'
        clops_h:
          description: Hardware Circuit Layer Operations Per Second (CLOPS_h). Measures how many circuit layers the QPU can execute per second on hardware.
          oneOf:
          - type: integer
            format: int32
            minimum: 0
            maximum: 2147483647
          - type: string
            pattern: ^.*$
          example: 4500
        clops_v:
          description: "Virtual CLOPS \u2014 may be a numeric value or descriptive string if unavailable."
          oneOf:
          - type: integer
            format: int32
            minimum: 0
            maximum: 2147483647
          - type: string
            pattern: ^.*$
          example: None
        conditional:
          type: boolean
          description: Backend supports conditional operations (true/false)
          default: false
          example: true
        conditional_latency:
          description: Array of dimension n_channels [d->u->m] x n_registers. Latency (in units of dt) to do a conditional operation on channel n from register slot m
          items:
            type: array
          example:
          - - 0
            - 1.2
          - - 0.5
            - 0.8
          type: array
        configurable:
          type: boolean
          description: Backend is configurable, if the backend is a simulator (true/false)
          default: false
          example: true
        coupling_map:
          type: array
          description: Array grouping qubits that are physically coupled together on the backend
          minItems: 1
          maxItems: 2147483647
          items:
            type: array
            minItems: 2
            maxItems: 2147483647
            items:
              type: integer
              format: int32
              minimum: 0
              maximum: 2147483647
          example:
          - - 0
            - 1
          - - 1
            - 2
        coords:
          type: array
          description: 'Array of [i, j] grid coordinates for each qubit''s position on the QPU topology. The index corresponds to the qubit index. Example: [[1,1],[1,2],[2,1],[2,2]] places Q0 at row 1 col 1, Q1 at row 1 col 2, Q2 at row 2 col 1, Q3 at row 2 col 2.'
          minItems: 1
          maxItems: 2147483647
          items:
            type: array
            minItems: 2
            maxItems: 2
            items:
              type: integer
              format: int32
              minimum: 0
              maximum: 2147483647
          example:
          - - 1
            - 1
          - - 1
            - 2
          - - 2
            - 1
          - - 2
            - 2
        credits_required:
          type: boolean
          description: Backend requires credits to run a job (true/false)
          default: false
          example: true
        description:
          type: string
          description: Description of the backend
          pattern: ^.*$
          minLength: 1
          maxLength: 64
          example: This backend supports 5 qubits and OpenPulse.
        display_name:
          type: string
          description: Alternate name field for the backend
          pattern: ^[a-zA-Z0-9]*$
          minLength: 1
          maxLength: 64
          example: EagleBackend
        discriminators:
          description: Available discriminators
          minItems: 1
          maxItems: 64
          example:
          - disc1
          - disc2
          type: array
          items:
            type: string
            maxLength: 64
            minLength: 1
            pattern: ^[a-zA-Z0-9]*$
        dt:
          type: integer
          format: int32
          description: Time discretization for the drive and U channels
          minimum: 0
          maximum: 2147483647
          example: 1
        dtm:
          type: integer
          format: int32
          description: Time discretization for the measurement channels
          minimum: 0
          maximum: 2147483647
          example: 1
        default_rep_delay:
          type: integer
          format: int32
          description: Default rep delay.
          minimum: 0
          maximum: 2147483647
          example: 3
        dynamic_reprate_enabled:
          type: boolean
          description: Whether delay between programs can be set dynamically using 'rep_delay'.
          default: false
          example: true
        gates:
          description: List of basis gates on the backend
          minItems: 1
          maxItems: 64
          type: array
          items:
            $ref: '#/components/schemas/GateConfig'
        hamiltonian:
          description: Hamiltonian of the backend
          deprecated: true
          allOf:
          - $ref: '#/components/schemas/Hamiltonian'
        local:
          type: boolean
          description: Backend is local or remote (true/false)
          example: true
        max_experiments:
          type: integer
          format: int64
          description: Maximum number of experiments supported
          minimum: 1
          maximum: 9007199254740991
          example: 10
        max_shots:
          type: integer
          format: int64
          description: Maximum number of shots supported
          minimum: 1
          maximum: 9007199254740991
          example: 1024
        meas_levels:
          description: Available measurement levels on the backend
          minItems: 1
          maxItems: 3
          items:
            type: array
          example:
          - 1
          - 2
          type: array
        meas_lo_range:
          description: Frequency range for the measurement LO
          minItems: 1
          maxItems: 2147483647
          items:
            type: array
          type: array
        meas_map:
          description: Grouping of measurement which are multiplexed
          minItems: 1
          maxItems: 2147483647
          items:
            type: array
          example:
          - - 0
            - 1
          - - 2
            - 3
          type: array
        measure_esp_enabled:
          type: boolean
          description: Whether ESP readout is supported by the backend.
          default: false
          example: true
        memory:
          type: boolean
          description: Backend supports memory (true/false)
          default: false
          example: true
        n_qubits:
          type: integer
          format: int32
          description: Number of qubits
          minimum: 1
          maximum: 2147483647
          default: 1
          example: 5
        n_registers:
          type: number
          description: Number of register slots available for feedback (if conditional is true)
          minimum: 1
          maximum: 2147483647
          default: 1
          example: 1
        n_uchannels:
          type: number
          description: Number of additional control channels
          minimum: 0
          maximum: 9007199254740991
          example: 2
        online_date:
          type: string
          description: Date the backend went online
          format: date-time
          minLength: 24
          maxLength: 24
          example: '2025-11-12T15:30:00.000Z'
        open_pulse:
          type: boolean
          description: If present, open_pulse = false schema applies
          example: true
        parametric_pulses:
          description: A list of available parametric pulse shapes
          minItems: 0
          maxItems: 1024
          items:
            type: array
          example:
          - Gaussian
          - Square
          type: array
        processor_type:
          description: The processor type of the device
          allOf:
          - $ref: '#/components/schemas/ProcessorType'
        quantum_volume:
          type: number
          description: Backend quantum volume
          minimum: 1
          maximum: 9007199254740991
          example: 32
        qubit_lo_range:
          description: Frequency range for the qubit LO
          minItems: 1
          maxItems: 2147483647
          items:
            type: array
          example:
          - - 4500000000
            - 5000000000
          - - 5100000000
            - 5600000000
          type: array
        register_map:
          description: An array of dimension n_qubits X n_registers indicating storage capability
          minItems: 1
          maxItems: 2147483647
          items:
            type: array
          example:
          - - 1
            - 0
          - - 0
            - 1
          type: array
        rep_delay_range:
          description: Range of delay times between programs (microseconds) allowed by backend.
          minItems: 2
          maxItems: 2
          example:
          - 100
          - 1000
          type: array
          items:
            type: number
        rep_times:
          description: Program execution times (microseconds) supported by backend.
          minItems: 1
          maxItems: 64
          items:
            type: number
          example:
          - 100
          - 200
          - 500
          type: array
        sample_name:
          type: string
          description: Sample name
          pattern: ^[a-zA-Z0-9,:\s]*$
          minLength: 1
          maxLength: 64
          example: Sample_01:Test
        simulator:
          type: boolean
          description: Backend is a simulator (true/false)
          default: false
          example: true
        supported_features:
          description: Array of features supported by the backend such as qasm3
          minItems: 0
          maxItems: 64
          example:
          - qasm3
          type: array
          items:
            type: string
        supported_instructions:
          description: Instructions supported by the backend.
          minItems: 0
          maxItems: 64
          example:
          - u1
          - cx
          - measure
          type: array
          items:
            type: string
        tags:
          description: Tags for the backend
          uniqueItems: true
          minItems: 1
          maxItems: 64
          example:
          - credits_required
          - simulator
          type: array
          items:
            type: string
        timing_constraints:
          description: Timing constraints of the backend
          allOf:
          - $ref: '#/components/schemas/TimingConstraints'
        u_channel_lo:
          type: array
          items:
            minItems: 1
            maxItems: 2147483647
            description: Relationship of the U Channel LO in terms of qubit LO
            type: array
            items:
              $ref: '#/components/schemas/UChannelLOItem'
    BackendDefaultsResponse:
      title: BackendsDefaultsResponse
      type: object
      description: Backends Defaults Response
      additionalProperties: true
    BackendPropertiesNduv:
      type: object
      properties:
        date:
          format: date-time
          type: string
          description: Date of the parameter
          minLength: 24
          maxLength: 24
        name:
          type: string
          description: Name of the parameter
          minLength: 1
          maxLength: 64
        unit:
          type: string
          description: Unit of the parameter
          minLength: 0
          maxLength: 64
        value:
          type: number
          description: Value of the parameter
      required:
      - date
      - name
      - unit
      - value
    BackendPropertiesResponse:
      type: object
      properties:
        backend_name:
          type: string
          description: Backend name
          pattern: ^[a-zA-Z0-9_]*$
          minLength: 1
          maxLength: 64
        backend_version:
          type: string
          description: Backend version in the form X.X.X
          pattern: ^[0-9]+.[0-9]+.[0-9]+$
          minLength: 5
          maxLength: 16
        gates:
          description: System gate parameters
          minItems: 0
          maxItems: 2147483647
          type: array
          items:
            $ref: '#/components/schemas/GateProperties'
        general:
          description: General system parameters
          minItems: 0
          maxItems: 2147483647
          type: array
          items:
            type: string
        last_update_date:
          format: date-time
          type: string
          description: Last date/time that a property was updated.
          minLength: 20
          maxLength: 20
        qubits:
          type: array
          items:
            description: System qubit parameters
            minItems: 1
            maxItems: 2147483647
            type: array
            items:
              $ref: '#/components/schemas/BackendPropertiesNduv'
      required:
      - backend_name
      - backend_version
      - gates
      - general
      - last_update_date
      - qubits
    BackendStatusResponse:
      title: BackendStatusResponse
      type: object
      description: Backends Status Response
      additionalProperties: false
      required:
      - length_queue
      properties:
        state:
          type: boolean
          description: State of the backend
        status:
          type: string
          description: Status of the backend
        message:
          type: string
          description: Description of the backend state
        length_queue:
          type: integer
          format: int32
          minimum: 0
          maximum: 2147483647
          description: Length of the queue for the backend
        backend_version:
          type: string
          description: Backend version
    BackendsResponse:
      title: BackendsResponse
      type: object
      description: Backends Response
      properties:
        devices:
          minItems: 1
          type: array
          description: A list of backends with their status
          items:
            type: object
            required:
            - name
            - status
            - queue_length
            properties:
              name:
                type: string
                description: The name of the backend device
                minLength: 1
                maxLength: 255
              status:
                type: object
                description: The status of the backend device
                properties:
                  name:
                    type: string
                    description: The status name of the backend device
                    enum:
                    - online
                    - paused
                    - offline
                  reason:
                    type: string
                    description: Optional reason for the status
                required:
                - name
              is_simulator:
                type: boolean
                description: Indicates if the device is a simulator
              qubits:
                type: integer
                format: int32
                minimum: 0
                maximum: 2147483647
                nullable: true
                description: The number of qubits in the device
              clops:
                type: object
                nullable: true
                description: Details of the CLOPS
                properties:
                  type:
                    type: string
                    enum:
                    - virtual
                    - hardware
                  value:
                    type: integer
                    format: int32
                    minimum: 0
                    maximum: 2147483647
                required:
                - type
                - value
              processor_type:
                type: object
                nullable: true
                description: Details of the processor type
                properties:
                  family:
                    type: string
                    nullable: true
                    description: The family of the processor
                  revision:
                    type: string
                    nullable: true
                    description: The revision of the processor
                  segment:
                    type: string
                    nullable: true
                    description: The segment of the processor
              queue_length:
                type: integer
                format: int32
                minimum: 0
                maximum: 2147483647
                description: The number of jobs waiting to be executed
              performance_metrics:
                $ref: '#/components/schemas/PerformanceMetrics'
              wait_time_seconds:
                type: object
                nullable: true
                description: Job wait times for the device (in seconds)
                properties:
                  average:
                    type: integer
                    format: int32
                    minimum: 0
                    maximum: 2147483647
                    description: Average wait time before jobs start running (in seconds)
                  p50:
                    type: integer
                    format: int32
                    minimum: 0
                    maximum: 2147483647
                    description: P50 wait time before jobs start running (in seconds)
                  p95:
                    type: integer
                    format: int32
                    minimum: 0
                    maximum: 2147483647
                    description: P95 wait time before jobs start running (in seconds)
                required:
                - average
                - p50
                - p95
      required:
      - devices
    ClopsType:
      type: object
      properties:
        type:
          type: string
          example: virtual
          enum:
          - virtual
          - hardware
        value:
          oneOf:
          - type: integer
            format: int32
            minimum: 0
            maximum: 2147483647
          - type: string
            pattern: ^.*$
          example: 100
      required:
      - type
      - value
    ComplexNumber:
      type: object
      properties:
        number:
          minItems: 2
          maxItems: 2
          items:
            type: array
          type: array
      required:
      - number
    GateConfig:
      type: object
      description: The definition of a gate
      required:
      - name
      - parameters
      - qasm_def
      properties:
        name:
          type: string
          description: The gate name as it will be referred to in QASM
          minLength: 1
          maxLength: 64
          pattern: ^[a-zA-Z0-9]*$
        parameters:
          type: array
          description: Variable names for the gate parameters (if any)
          minItems: 0
          maxItems: 1024
          items:
            type: string
            minLength: 1
            maxLength: 64
            pattern: ^[a-zA-Z0-9]*$
        coupling_map:
          type: array
          minItems: 1
          maxItems: 2147483647
          items:
            type: array
            minItems: 1
            maxItems: 2147483647
            items:
              type: integer
              format: int32
              minimum: 0
              maximum: 2147483647
          description: List of qubit groupings which are coupled by this gate
        qasm_def:
          type: string
          description: Definition of this gate in terms of QASM primitives U and CX
          pattern: ^.*$
          minLength: 1
          maxLength: 1024
        conditional:
          type: boolean
          description: This specified gate supports conditional operations (true/false). If this is not specified, then the gate inherits the conditional property of the backend.
          default: false
        latency_map:
          type: array
          minItems: 1
          maxItems: 2147483647
          items:
            type: array
            minItems: 1
            maxItems: 2147483647
            items:
              type: integer
              format: int32
              minimum: 0
              maximum: 1
          description: An array of dimension len(coupling_map) X n_registers that specifies (1 - fast, 0 - slow) the register latency conditional operations on the gate
        description:
          type: string
          description: Description of the gate operation
          minLength: 1
          maxLength: 64
          pattern: ^[a-zA-Z0-9\s]*$
    GateProperties:
      type: object
      properties:
        gate:
          type: string
          description: The gate name for these parameters
          minLength: 1
          maxLength: 64
          pattern: ^[a-zA-Z0-9_]*$
        parameters:
          description: The parameters of this gate on these qubits
          minItems: 1
          maxItems: 2147483647
          type: array
          items:
            $ref: '#/components/schemas/BackendPropertiesNduv'
        qubits:
          description: The qubits for these parameters
          minItems: 1
          maxItems: 2147483647
          type: array
          items:
            type: string
      required:
      - gate
      - parameters
      - qubits
    Hamiltonian:
      type: object
      description: Hamiltonian of the backend
      properties:
        h_latex:
          type: string
          description: The Hamiltonian in latex form
          minLength: 1
          maxLength: 4096
          pattern: ^.*$
        h_str:
          type: array
          description: The Hamiltonian in machine readable form
          minItems: 1
          maxItems: 2147483647
          items:
            type: string
            minLength: 1
            maxLength: 1024
            pattern: ^.*$
          example:
          - '"0.5 * X0 Y1"'
          - '"1.0 * Z0"'
        vars:
          type: object
          description: Variables in the h_str
        osc:
          type: object
          description: Number of levels for each oscillator mode
      required:
      - h_latex
    PerformanceMetrics:
      type: object
      properties:
        two_q_error_best:
          description: 2Q error (best)
          allOf:
          - $ref: '#/components/schemas/TwoQErrorBest'
        two_q_error_layered:
          description: 2Q error (layered)
          allOf:
          - $ref: '#/components/schemas/TwoQErrorLayered'
        two_q_error_median:
          description: 2Q error (median)
          allOf:
          - $ref: '#/components/schemas/TwoQErrorMedian'
        readout_error_median:
          description: Readout error (median)
          allOf:
          - $ref: '#/components/schemas/ReadoutErrorMedian'
    ProcessorType:
      type: object
      description: The processor type of this backend
      required:
      - family
      - revision
      properties:
        family:
          type: string
          description: Processor family indicates quantum chip architecture
          minLength: 1
          maxLength: 64
          pattern: ^[a-zA-Z0-9]*$
        revision:
          type: string
          description: Revision number reflects design variants within a given processor family. Is typically a semantic versioning value without the patch value, eg., \"1.0\".
          minLength: 1
          maxLength: 64
          pattern: ^[0-9]+.[0-9]+$
        segment:
          type: string
          description: Segment, if indicated, is used to distinguish different subsets of the qubit fabric/chip
          minLength: 1
          maxLength: 64
          pattern: ^[a-zA-Z0-9]*$
    ReadoutErrorMedian:
      type: object
      properties:
        value:
          type: number
          example: 0.3442341
        unit:
          type: strin

# --- truncated at 32 KB (34 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/ibm-quantum/refs/heads/main/openapi/ibm-quantum-runtime-backends-openapi.yml