Skip to main content
Monitor quantum jobs across all providers from a single interface. View job status, results, and costs. Use this when you want to:
  • Check the status of submitted quantum jobs
  • View results from completed experiments
  • Track costs across providers
  • Bundle related jobs into groups (qbraid jobs groups)
Usage:
Options:
  • --help: Show this message and exit.
Commands:
  • submit: Submit a quantum job.
  • list: List quantum jobs.
  • get: Get a qBraid Quantum Job.
  • groups: Manage job groups.

​
qbraid jobs submit

Submit a quantum job. Submit a quantum program to a device on the qBraid platform. The program can be provided as a file path or piped via stdin. Examples:
Usage:
Arguments:
  • program: Path to a quantum program file, or ’-’ to read from stdin. [required]
Options:
  • -d, --device <str>: Target device QRN (e.g. ‘qbraid:qbraid:sim:qir-sv’). [required]
  • -f, --format <qasm2|qasm3|qir.bc|qir.ll|analog|pulser.sequence|quil|ionq.circuit.v0|problem>: Program format. Required when reading from stdin. Auto-detected from file extension when omitted. Options: qasm2, qasm3, qir.bc, qir.ll, analog, pulser.sequence, quil, ionq.circuit.v0, problem
  • -s, --shots <int range>: Number of shots to execute. [x>=1]
  • -n, --name <str>: Job name.
  • -t, --tags <str>: Job tags as a JSON object (e.g. ’{“experiment”:“bell”}’).
  • --options <str>: Runtime options as a JSON object.
  • --group <str>: Group job QRN to associate this job with.
  • --json: Output full job response as JSON (for programmatic use).
  • --help: Show this message and exit.

​
qbraid jobs list

List quantum jobs. Lists quantum jobs submitted through the qBraid platform. Usage:
Options:
  • -l, --limit <int>: Limit the maximum number of results returned [default: 10]
  • -s, --status <INITIALIZING|QUEUED|VALIDATING|RUNNING|CANCELLING|CANCELLED|COMPLETED|FAILED|UNKNOWN|HOLD>: Filter by status: INITIALIZING, QUEUED, VALIDATING, RUNNING, CANCELLING, CANCELLED, COMPLETED, FAILED, UNKNOWN, HOLD
  • -v, --vendor <aws|azure|ibm|ionq|qbraid>: Filter by vendor: AWS, AZURE, IBM, IONQ, QBRAID
  • -p, --provider <aqt|aws|azure|equal1|ibm|iqm|ionq|nec|oqc|pasqal|quantinuum|quera|rigetti|qbraid>: Filter by provider: AQT, AWS, AZURE, EQUAL1, IBM, IQM, IONQ, NEC, OQC, PASQAL, QUANTINUUM, QUERA, RIGETTI, QBRAID
  • --page <int>: Page number for pagination [default: 1]
  • --help: Show this message and exit.

​
qbraid jobs get

Get a qBraid Quantum Job. Usage:
Arguments:
  • job_id: The QRN or ID of the job to get. [required]
Options:
  • --no-fmt: Disable rich console formatting (output raw data) [default: True]
  • --help: Show this message and exit.

​
qbraid jobs groups

Manage job groups. A group bundles related jobs into one session so the runtime can track aggregate cost and status. Submit into a group with qbraid jobs submit --group &lt;qrn&gt;. Quick start:
Usage:
Options:
  • --help: Show this message and exit.
Commands:
  • list: List your job groups.
  • info: Show full details for one group.
  • create: Create a new group.
  • close: Close a group to new submissions.
  • cancel: Cancel a group and its non-terminal jobs.
  • jobs: List the jobs in a group.
  • delete: Delete a group record.

​
qbraid jobs groups list

List your job groups. Usage:
Options:
  • -s, --status <str>: Filter by status (OPEN/CLOSED/COMPLETED/FAILED/CANCELLED)
  • -p, --page <int range>: Page number [x>=1]
  • -l, --limit <int range>: Results per page [x>=1]
  • --help: Show this message and exit.

​
qbraid jobs groups info

Show full details for one group. Usage:
Arguments:
  • qrn: Group QRN [required]
Options:
  • --help: Show this message and exit.

​
qbraid jobs groups create

Create a new group. Returns the new group’s QRN — pass it to qbraid jobs submit --group to attach jobs into the group. Usage:
Options:
  • -n, --name <str>: Human-readable group name
  • -t, --tags <str>: Comma-separated key=value tags (values stored as strings)
  • -m, --metadata <str>: Comma-separated key=value metadata (values stored as strings)
  • --max-ttl <int range>: Max time-to-live in seconds (1-86400) [1<=x<=86400]
  • --help: Show this message and exit.

​
qbraid jobs groups close

Close a group to new submissions. Existing jobs continue running; only new submissions are blocked. Usage:
Arguments:
  • qrn: Group QRN [required]
Options:
  • --help: Show this message and exit.

​
qbraid jobs groups cancel

Cancel a group and its non-terminal jobs. Usage:
Arguments:
  • qrn: Group QRN [required]
Options:
  • -f, --force: Skip confirmation
  • --help: Show this message and exit.

​
qbraid jobs groups jobs

List the jobs in a group. Requires qbraid-core >= 0.3.3 (the get_group_jobs helper). Usage:
Arguments:
  • qrn: Group QRN [required]
Options:
  • --help: Show this message and exit.

​
qbraid jobs groups delete

Delete a group record. Underlying jobs are not affected — cancel the group first if you want to stop them. Idempotent: deleting an already-deleted group is a no-op. Requires qbraid-core >= 0.3.3 (the delete_group helper). Usage:
Arguments:
  • qrn: Group QRN [required]
Options:
  • -f, --force: Skip confirmation
  • --help: Show this message and exit.