START NOW
V2 Platform

Legacy Jobs Retrieval

Following the migration to qBraid’s V2 platform, quantum jobs from the legacy platform are no longer directly accessible through the new API. However, you can download and work with your legacy jobs data using the instructions below.

Schema Changes

Legacy jobs will not match the schema of the new runtime jobs in API V2. If you’re working with both legacy and new jobs, be aware that their data structures and field names will differ.

For more details, see the API Reference for V2 Jobs.

Downloading legacy jobs data

  1. Log in to your qBraid account at account.qbraid.com
  2. Navigate to the Jobs page
  3. Look for the Download Old Jobs option
  4. Click to export all your legacy quantum jobs as a JSON file
  5. Save the JSON file to your local machine

Displaying legacy jobs with qBraid-SDK

Once you’ve downloaded your legacy jobs JSON file, you can view the jobs data using the qBraid-SDK.

Prerequisites

Ensure you have qBraid-SDK version 0.10.2 installed:

pip install 'qbraid==0.10.2'

Loading the data

from qbraid.runtime import QbraidProvider

# Path to the legacy jobs JSON file

legacy_jobs_path = 'legacy_jobs.json'

# Initialize the provider with the legacy jobs path

provider = QbraidProvider(legacy_jobs_path=legacy_jobs_path)

# Display the first 5 jobs

print(provider.display_jobs(max_results=5))

Displaying 5/5 jobs matching query:

Job ID    | Submitted                 | Status
--------- | ------------------------- | ---------------
<job_id_1> | 2025-12-31 T17:52:46.850Z | COMPLETED
<job_id_2> | 2025-11-06 T13:29:16.031Z | FAILED
<job_id_3> | 2025-10-31 T17:52:44.674Z | CANCELLED
<job_id_4> | 2025-10-31 T17:52:42.551Z | COMPLETED
<job_id_5> | 2025-10-28 T09:32:11.508Z | COMPLETED

Functionality and limitations

Once the QbraidProvider is initialized with the legacy jobs JSON path, you can only use the display_jobs() method to display the jobs.

Methods that interface with the API, such as get_device(), will not work when using legacy jobs. This is because device information is not available through the old API endpoints.

For full functionality including device access and job submission, upgrade to qBraid-SDK version 0.11.0 or greater and use the new V2 API endpoints. See the V2 SDK documentation for details.

Retrieving job details with qbraid-core

For more detailed information about individual jobs, you can use the qbraid-core library, which provides direct access to job metadata and results.

Prerequisites

Install qbraid-core version0.1.50:

pip install 'qbraid-core==0.1.50'

Using QuantumClient

The QuantumClient accepts the same legacy jobs JSON path parameter and provides methods for retrieving detailed job information:

from qbraid_core.services.quantum import QuantumClient

# Initialize the client with the legacy jobs JSON path
legacy_jobs_path = 'legacy_jobs.json'
client = QuantumClient(legacy_jobs_path=legacy_jobs_path)

# List all jobs
jobs_list = client.search_jobs()

# display the first 5 jobs
print(jobs_list[:5])

# Get detailed information for a specific job
job_id = jobs_list[0]['qbraidJobId']
job_details = client.get_job(job_id)
print(job_details)

Available methods

  • search_jobs() - Returns a list of all legacy jobs
  • get_job(job_id) - Retrieves detailed metadata for a specific job
  • get_job_result(job_id) - Fetches the results and measurements for a completed job

Need help?

If you encounter any issues retrieving or working with your legacy jobs data, contact contact@qbraid.com.