Building a Transit Service Query by URL

The Transit Service web interface can be pre-populated with values to configure the query you want run in the service using a constructed URL. Please note that this feature cannot be used to automate queries; you will need to run the HTTPS request from the browser manually. However, this feature can save you some time and effort when submitting the same type of query repeatedly because your targets, (either a data set or specific target names), time span, observer location, and/or phases are already specified.

Please note that custom transit parameters, such as Observed Transit Midpoint or Transit Duration, are not supported, but may be entered manually in the web application.

How to Construct A Web Query

URLs start with the transit service base URL:

https://exoplanetarchive.ipac.caltech.edu/cgi-bin/TransitView/nph-visibletbls?dataset=transits

To specify a data set, add an ampersand (&) and any of the following keywords:

Keyword	Data Set
&conf_all	All Confirmed Planets
&conf_tran	Confirmed Transiting Planets
&conf_rv	Confirmed Radial Velocity Planets
&koi_conf	Confirmed Kepler Objects of Interest
&koi_cand	Candidate Kepler Objects of Interest
&koi_fp	False Positive Kepler Objects of Interest
&k2_conf	Confirmed K2 Candidates
&k2_cand	Candidate K2 Candidates
&k2_fp	False Positive K2 Candidates
&toi	All TESS Objects of Interest

The &koi_conf, &koi_cand and &koi_fp keywords return the expected subsets (e.g., &koi_fp returns the false positive KOIs). You may also include multiple subset keywords in the URL such as &koi_conf&koi_cand to return all confirmed KOIs and all candidate KOIs.

https://exoplanetarchive.ipac.caltech.edu/cgi-bin/TransitView/nph-visibletbls?dataset=transits&conf_rv

https://exoplanetarchive.ipac.caltech.edu/cgi-bin/TransitView/nph-visibletbls?dataset=transits&koi_conf

https://exoplanetarchive.ipac.caltech.edu/cgi-bin/TransitView/nph-visibletbls?dataset=transits&koi_all&&koi_cand&k2_fp

To see next transits for a specific target name, use the &sname= keyword:

https://exoplanetarchive.ipac.caltech.edu/cgi-bin/TransitView/nph-visibletbls?dataset=transits&name=kepler22b

To see all archive references for a particular target, specify the target using &sname= and add &getReferences to the url:

https://exoplanetarchive.ipac.caltech.edu/cgi-bin/TransitView/nph-visibletbls?dataset=transits&sname=kepler22b&getReferences

To see the parameters for a target's 'Most Precise' ephemeris, specify the target using &sname= and add &getParams to the url:

https://exoplanetarchive.ipac.caltech.edu/cgi-bin/TransitView/nph-visibletbls?dataset=transits&sname=kepler22b&getParams

To specify a time span, use the &bJD and &eJD, or nextTransit keywords. &nextTransit is the default.

https://exoplanetarchive.ipac.caltech.edu/cgi-bin/TransitView/nph-visibletbls?dataset=transits&bJD=2454780&eJD=2454800

https://exoplanetarchive.ipac.caltech.edu/cgi-bin/TransitView/nph-visibletbls?dataset=transits&koi&nextTransit

To specify an observer location, use the &lat and &lon keywords. No observer location is the default.

https://exoplanetarchive.ipac.caltech.edu/cgi-bin/TransitView/nph-visibletbls?dataset=transits&rv&lat=19.87&lon=-155.5

To specify an observatory, use the &site keyword followed by a keyword that uniquely identifies the observatory, e.g. &site=keck. Refer to the drop-down list in the Location pane and then use part of the observatory name that makes it unique.

Space observatories:

https://exoplanetarchive.ipac.caltech.edu/cgi-bin/TransitView/nph-visibletbls?dataset=transits&site=jwst

Earth observatories:

https://exoplanetarchive.ipac.caltech.edu/cgi-bin/TransitView/nph-visibletbls?dataset=transits&site=mcdonald

https://exoplanetarchive.ipac.caltech.edu/cgi-bin/TransitView/nph-visibletbls?dataset=transits&site=lick

To specify phases, use the &phase= keyword—supported values include primary, secondary and quadrature. primary is the default.

https://exoplanetarchive.ipac.caltech.edu/cgi-bin/TransitView/nph-visibletbls?dataset=transits&sname=kepler115c&phase=primary,secondary

The above keywords are optional, and they can be used in combination.

This query computes next transit events for all radial velocity (RV) planets:

https://exoplanetarchive.ipac.caltech.edu/cgi-bin/TransitView/nph-visibletbls?dataset=transits&rv

This query computes all predicted secondary transit events for Kepler-33 b that occurred between May 13, 2008 and March 9, 2009, and that were viewable from a lat/lon location of 19.87/-155.5:

https://exoplanetarchive.ipac.caltech.edu/cgi-bin/TransitView/nph-visibletbls?dataset=transits&sname=kepler33b&bJD=2454600&eJD=2454900&phase=secondary&lat=19.87&lon=-155.5

«Previous Refining Transit Settings Transit Usage Tips and Troubleshooting Next »

Last updated: 11 February 2020