qbraid jobs

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:

$ qbraid jobs [OPTIONS] COMMAND [ARGS]...

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:

qbraid jobs submit circuit.qasm -d qbraid:qbraid:sim:qir-sv --shots 100

cat circuit.qasm | qbraid jobs submit - -d qbraid:qbraid:sim:qir-sv -f qasm2

qbraid jobs submit program.ll -d qbraid:qbraid:sim:qir-sv --json

Usage:

$ qbraid jobs submit [OPTIONS] {program}

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:

$ qbraid jobs list [OPTIONS]

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:

$ qbraid jobs get [OPTIONS] {job_id}

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 <qrn>.

Quick start:

qbraid jobs groups create -n my-batch
qbraid jobs groups list
qbraid jobs groups info <qrn>
qbraid jobs groups jobs <qrn>
qbraid jobs groups close <qrn>     # no more submissions, jobs run
qbraid jobs groups cancel <qrn>    # cancel group + non-terminal jobs
qbraid jobs groups delete <qrn>    # remove the record

Usage:

$ qbraid jobs groups [OPTIONS] COMMAND [ARGS]...

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:

$ qbraid jobs groups list [OPTIONS]

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:

$ qbraid jobs groups info [OPTIONS] {qrn}

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:

$ qbraid jobs groups create [OPTIONS]

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:

$ qbraid jobs groups close [OPTIONS] {qrn}

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:

$ qbraid jobs groups cancel [OPTIONS] {qrn}

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:

$ qbraid jobs groups jobs [OPTIONS] {qrn}

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:

$ qbraid jobs groups delete [OPTIONS] {qrn}

Arguments:

qrn: Group QRN [required]

Options:

-f, --force: Skip confirmation
--help: Show this message and exit.