qbraid.runtime.quantinuum.queue_lengths

queue_lengths(device_names=None)

Return a mapping of NEXUS device name to the number of jobs queued on it.

Parameters:

device_names (Sequence[str] | None) – Restrict the query to these devices. Omit to return every Quantinuum device visible to the authenticated account.

Return type:

dict[str, int]

Returns:

Device name mapped to queue length. Devices NEXUS does not report are absent rather than zero, so a caller can tell “nothing queued” from “no answer”.

Raises:

ResourceNotFoundError – The endpoint could not be reached or refused the request.