Help: COVE API User's Guide: Missions

Missions is a list of forecasted or archived missions. Forecasted missions are used in Acquisition Forecaster, Revisits Calculator, and Coincident Calculator. Archived missions are used in Data Browser, Coverage Analyzer, and Coincident Calculator. The missions results will help users determine correct mission, instrument, and mode names as well as determine valid start and end dates when creating tasks.

Missions throttle limits:
  • GET: 120 requests per hour
 

Retrieve forecasted list

Request Method: GET
 
Request URL:
https://ceos-cove.org/en/api/v1_2/missions/forecasted/
 
URL Parameters: None
 
Response Example:
[
{
"mission": "ALOS",
"norad_id": "28931",
"mim_id": 242,
"launch_date": "2006-01-24",
"decommissioned_date": "2011-04-22",
"earliest_tle_date": "2006-01-25",
"latest_tle_date": "2011-07-20",
"status": "deactivated",
"instrument_modes": [
{
"instrument": "PRISM",
"mode": "Nadir"
}, {
"instrument": "AVNIR-2",
"mode": "Standard"
}, {
"instrument": "AVNIR-2",
"mode": "Full Accessible"
}, {
"instrument": "PALSAR",
"mode": ""
}
]
},
(MISSIONS LIST TRUNCATED)
]
 

Retrieve archived list

Request Method: GET
 
Request URL:
https://ceos-cove.org/en/api/v1_2/missions/archived/
 
URL Parameters: None
 
Response Example:
[
{
"mission": "Landsat 5",
"norad_id": "14780",
"mim_id": 226,
"launch_date": "1984-03-01",
"decommissioned_date": "2013-06-05",
"latest_acquisition_date": "2012-05-05",
"status": "deactivated",
"instrument_modes": [
{
"instrument": "TM",
"mode": ""
}
]
},
(MISSIONS LIST TRUNCATED)
]
 

Example API requests using curl

Forecasted missions list:
curl -H 'Accept: application/json; indent=4' -u username:password https://ceos-cove.org/en/api/missions/forecasted/
 
Archived missions list:
curl -H 'Accept: application/json; indent=4' -u username:password https://ceos-cove.org/en/api/missions/archived/