GOES SXI - ImageService Web API

Request URL

A typical GOES SXI Image service request URL is of the following form:

where,
goes_satellite_number indicates the satellite number. This service provides access to the following GOES Satellite data: GOES-12 , GOES-13 , GOES-14 , GOES-15. Example:

• goes12
• goes13

product_type indicates the level of the products. It may be either of the following values:

• level0 - Unprocessed (Level-0) images are raw and uncalibrated
• level1 - Processed (Level-1) images have been calibrated, rotated, etc

output indicates the response format. It may be either of the following values:

• html - generates output in an HTML page (Default)
• xml - generates output in XML format
• txt - generates output in Text format
• json - generates output in JSON (JavaScript Object Notation) format

Data Request Parameters

Few of the parameters are required while the others are optional. The parameters are separated by ampersand(&) in the request URL.

• fromDate (Required) - Defines the start date and time from which to obtain data.It is represented by the following date format:   yyyyMMddHHmmss
  Eg: 20110201000223
• toDate (Required) - Defines the end date and time from which to obtain data.It is represented by the following date format:   yyyyMMddHHmmss
  Eg: 20110201120203
  NOTE: Please limit to 12 months of data download.
• imgFormat (Required) - Response format of the images. It may be either of the following values:
  • fts - for FITS format
  • png - for PNG format
• imgType (Optional) - Indicates what solar phenomenon has been targeted by the exposure parameters. Image type values differs depending on the satellite number and the level of products. Click on the links below to see valid Image type values for each satellites.
  GOES-12   |   GOES-13   |   GOES-14   |   GOES-15
• wavelength (Optional) - Indicates the filter mnemonic. Wavelength values depends on the Image type values. Click on the links above to view valid wavelength values for a particular satellite, product level and Image type.
• fromExpTime (Optional) - Defines the Exposure time which is the actual image integration time in seconds.
  Valid range: 0.0 - 20.0
• toExpTime (Optional) -Defines the Exposure time which is the actual image integration time in seconds.
  Valid range: 0.0 - 20.0

NOTE: Omitting the Optional parameters from the Request URL returns SXI images of all Image types, wavelength and exposure times. The use of Optional parameters refines your search for SXI images.

Response Formats

The Web Service supports the following response formats: HTML (Default), XML, JSON and Text.
See Response Formats, for more information on the formats supported and how to debug the error responses.

Example Request for GOES SXI service

A sample HTTP request is shown below, that downloads URLs of the images in HTML format

http://www.ngdc.noaa.gov/goes/sxi/getImageURL/goes15/level1.html?fromDate=20110901000000&toDate=20110912235959&imgFormat=png&imgType=CS&wavelength=PTHNA&fromExpTime=0.3&toExpTime=0.4