List Qpus And Simulators

curl --request POST \
  --url 'https://api.example.com/ai/list_qpus_and_simulators?HAIQU_API_KEY='

[
  {
    "id": "<string>",
    "vendor": "<string>",
    "name": "<string>",
    "qubits": 123,
    "status": "<string>",
    "pending_jobs": 123,
    "simulator": true
  }
]

API Reference

List Qpus And Simulators

List available QPUs and simulators for execution planning.

Use this tool before execution submission to obtain a valid device_id for run_circuits_on_qpu_or_simulator. The route is read-only and does not reserve capacity or start jobs, so queue depth and status values are only snapshots.

When to Use:

Call this before run submission or backend-aware transpilation when a valid device_id is not yet known.
Call this when the user wants to compare available QPUs and simulators by capacity or queue depth.

Constraints:

Returned backend status and pending-job counts are point-in-time snapshots only.
Use the returned id values verbatim in later MCP tools.

Notes:

For agent-facing output, summarize the most relevant backends by simulator flag, qubit count, and pending jobs instead of pasting the full catalog unless the caller asks for exhaustive results.

Args: user: Authenticated user resolved from the API key. db: Active database session.

Returns: A list of execution backend objects with IDs suitable for later run submissions.

POST

list_qpus_and_simulators

List Qpus And Simulators

curl --request POST \
  --url 'https://api.example.com/ai/list_qpus_and_simulators?HAIQU_API_KEY='

[
  {
    "id": "<string>",
    "vendor": "<string>",
    "name": "<string>",
    "qubits": 123,
    "status": "<string>",
    "pending_jobs": 123,
    "simulator": true
  }
]

Authorizations

HAIQU_API_KEY

string

query

required

Response

200 - application/json

Successful Response

string

required

vendor

string

required

name

string

required

qubits

integer

required

status

string

required

pending_jobs

integer

required

simulator

boolean

required

Get Job Results And Status Run Circuits On Qpu Or Simulator

⌘I