How Do You Search and Access Data in NASA's HEASARC Archive?

HEASARC (NASA's High Energy Astrophysics Science Archive Research Center) is the primary multi-mission archive for extreme ultraviolet (EUV), X-ray, and gamma-ray astronomy data, and it also covers cosmic microwave background (CMB) datasets through its LAMBDA center. You can search it through the Archive Quick Search or the Xamin portal, retrieve results via the web portal, the Xamin API, astroquery, or Virtual Observatory protocols, and analyze data directly in the cloud on SciServer or the Fornax Initiative. This guide covers the search workflow, the access routes, and the software you need to go from a query to a usable dataset.

What HEASARC Actually Holds

Before searching, it helps to know what you are searching across. HEASARC is NASA's designated multi-mission archive for cosmic astronomy datasets in the EUV, X-ray, and gamma-ray wave bands, plus CMB datasets. LAMBDA is the associated NASA center of expertise for CMB research, providing archive data from cosmology missions and software tools.

The archive spans many active and past missions, including:

• X-ray and EUV: Chandra, XMM-Newton, ROSAT, Swift, NICER, NuSTAR, IXPE, Einstein Probe, XRISM, XPoSat, MAXI, SRG eRosita / ART-XC
• Gamma-ray and high-energy: Fermi, CALET, DAMPE, AMS-02, GECAM, GRBBeta, HXMT-Insight
• Other: AstroSat, SVOM, TESS, BlackCAT

Because the archive is multi-mission, a single query can return observations of the same object from several instruments, which is often what you want when comparing coverage across wave bands.

Searching with Archive Quick Search

The Archive Quick Search is the fastest entry point. It queries the HEASARC database directly and redirects you to the search portal once the query runs.

The query syntax combines a target or table name with conditions. The site's own examples show the pattern:

The logic: name the object or table, then add constraints such as exposure>10000 or status='archived'. Multi-table queries (as in the Messier example) let you join conditions across tables using aliases like a. and b..

Expected result: the query runs against the HEASARC database and you are redirected to the search portal with matching rows. If a query returns nothing, the usual causes are a misspelled object name, a constraint that is too tight (for example an exposure threshold above what any observation reaches), or a table name that does not exist in the archive.

Using Xamin for Deeper Exploration

Xamin is the interactive web portal for data discovery and exploration. The classic Browse portal remains available if you prefer the older interface. Xamin is the better choice when you want to filter interactively rather than write a query string, and it is also the backend behind the API access routes described below.

Four Ways to Retrieve Data

HEASARC offers several access routes, and the right one depends on whether you are working interactively or scripting a pipeline.

1. Web portal (Xamin or classic Browse) — best for one-off exploration and visual inspection of results.
2. Xamin API — best for scripted or repeated queries where you want machine-readable output.
3. astroquery Heasarc module — best if you already work in Python and want to query HEASARC from a notebook.
4. Virtual Observatory protocols via pyvo — best if you need interoperability with other VO-compatible archives and tools.

All four reach the same underlying archive, so the choice is about your workflow, not about data coverage.

Analyzing Data in the Cloud

You do not have to download data to work with it. HEASARC@SciServer is an analysis-ready platform where both data and software are available through the browser. HEASARC is also part of the NASA Fornax Initiative, which is building NASA's next-generation cloud-based science platform; the Fornax Initiative is currently welcoming interested beta users, and you can analyze HEASARC, IRSA, and MAST data in the cloud there.

This matters because high-energy analysis often requires large calibration files and mission-specific software. Running in the cloud avoids installing and maintaining that stack locally.

Software for High-Energy Data

For local analysis, HEASoft is the core package. HEASoft 6.37.0 is available, and HEASoft and XSPEC are distributed as conda packages. On SciServer, HEASoft and other high-energy software — including CAIO, XMM-SAS, Fermitools, and Spex — are already installed and available.

One version note worth checking before you start: NuSTARDAS v2.1.6 is required for recent NuSTAR observations. Analyzing any observations taken on or after September 24, 2026 requires NuSTARDAS v2.1.6 in the latest HEASoft v6.37.1 release. The general analysis process itself is unchanged — only the calibration software version requirement differs.

A Practical Starting Sequence

If you are new to the archive, this order avoids most dead ends:

1. Identify your target and which mission likely observed it.
2. Run an Archive Quick Search with the object name plus a mission or table name.
3. If you get too many or too few rows, add or relax a constraint such as exposure or status.
4. Move to Xamin if you need interactive filtering.
5. Choose an access route — portal, API, astroquery, or pyvo — based on whether you are exploring or scripting.
6. Decide whether to analyze locally with HEASoft/XSPEC or in the cloud on SciServer or Fornax.
7. Check the required software version for your mission before reducing data.

The archive is free to use for scientists and astronomy enthusiasts, and it provides archival data, multi-mission software and analysis tools, and information about current and past observatory missions.