MAST API
Tools for programmatically querying the MAST Portal.
CAOM Field Descriptions
Column Name Column Label Description Examples/Valid Values Data Type Units
calib_level Calibration Level Calibration level 0 = raw, 1 = uncalibrated, 2 = calibrated, 3 = science product, 4 = contributed science product integer
dataRights Data Rights Data Rights valid values: public,exclusive_access,restricted string
dataURL Data URL Data URL string
dataproduct_type Product Type Type of product Valid values: IMAGE, SPECTRUM, SED, TIMESERIES, VISIBILITY, EVENTLIST, CUBE, CATALOG, ENGINEERING, NULL string
distance Distance (") Angular separation between searched coordinates and center of obsevation float arcsec
em_max Max. Wavelength Maximum Wavelength float nm
em_min Min. Wavelength Minimum Wavelength float nm
filters Filters Instrument filters F469N, NUV, FUV, LOW DISP, MIRROR string, multi-value separator ';'
instrument_name Instrument Instrument Name E.g. WFPC2/WFC, UVOT, STIS/CCD string
jpegURL jpegURL Preview Image URL https://archive.stsci.edu/hst/previews/N4QF/N4QF18090.jpg string
mtFlag Moving Target Moving Target Flag If True, observation contains a moving target, if False or absent observation may or may not contain a moving target boolean
objID Object ID Plane ID of observation at given calibration level Long integer, e.g. 2012969445 integer
obs_collection Mission Collection E.g. SWIFT, PS1, HST, IUE string, multi-value separator ';'
obs_id Observation ID Observation identifier, given by mission U24Z0101T, N4QF18030 string
obs_title Observation Title Observation description from proposal Age-dating Star Clusters in M101 string
obsid Product Group ID Database identifier for obs_id Long integer, e.g. 2007590987 integer
project Project Processing project E.g. HST, HLA, EUVE, hlsp_legus string, multi-value separator ';'
proposal_id Proposal ID Proposal ID E.g. EGCJC, 11360, 9401 string
proposal_pi Principal Investigator Principal investigator's last name Chander, Chu, Malkin string
proposal_type Proposal Type Type of telescope proposal Eg. 3PI, GO, GO/DD, HLA, GII, AIS string
provenance_project Provenance Project Project name used by data provider E.g. CAL/STIS, AIS, PS1, GO, ENG/STIS/PAR string
s_dec Dec Observation Declination May be displayed in the Portal as hh:mm:ss.sss, but should be searched as decimal float deg
s_ra RA Observation Right Ascension May be displayed in the Portal as hh:mm:ss.sss, but should be searched as decimal float deg
s_region s_region STC/S Footprint Will be ICRS circle or polygon. E.g. CIRCLE ICRS 17.71740689 -58.40043015 0.625 string ICRS Shape
sequence_number Sequence Number Sequence number, e.g. Kepler quarter or TESS sector integer
srcDen Number of Catalog Objects Number of cataloged objects found in observation float
t_exptime Exposure Length Exposure time float sec
t_max End Time Observation end datetime May be displayed in the Portal as YYY-MM-DD HH:MM, but should be searched as MJD float MJD
t_min Start Time Observation start datetime May be displayed in the Portal as YYY-MM-DD HH:MM, but should be searched as MJD float MJD
t_obs_release Release Date Dataset release date May be displayed in the Portal as YYY-MM-DD HH:MM, but should be searched as MJD float MJD
target_classification Target Classification Type of target Ex. COMET;COMET BEING ORBITED BY THE ROSETTA SPACECRAFT;SOLAR SYSTEM string, multi-value separator ';'
target_name Target Name Target Name Ex. COMET-67P-CHURYUMOV-GER-UPDATE string
wavelength_region Waveband Energy Band EUV, XRAY, OPTICAL string, multi-value separator ';'