HTTP Direct Data Request

NOTICE! While the Direct Access option to extract data from the GCOOS Data Portal provides flexibility and allows the download of most recent data, it can be slow. Pre-generated CSV files are also available on the GCOOS WAF facility. We encourage users to use the GCOOS WAF to download monthly summaries. Data in netCDF4 data format is also available for data summarized by platforms or stations. Whenever possible, use the GCOOS ERDDAP data services for in situ data.

Data Call Interactive

The following is a form to interactively retrieve data using a form (see the tab on Data Call Instructions for more on this). To retrieve data, simply provide the inputs and click on the [Retrieve Data] button to generate the CSV file.

Spatial Coverage

(The default values provided are the coordinates for a full coverage of the Gulf of Mexico. You may use the map in the introductory page to get new coordinates if necessary.)

Temporal Coverage
(The date and time inputs will not be validated when retrieving records.)

  Year (YYYY) Month Day (DD)   Hour (HH) Minutes (MM) Seconds (SS)


NOTE: All observations are served by this portal as they become available. The list can change. If 'Currents' is selected, direct access limits the range to the last 3 days of observation due to the size of the return. Contact GCOOS if access to historical data older than 3 days are needed, or use the GCOOS WAF.

Select the observation to retrieve:

QC Flags

The QC flag is composed of 8 digits that correspond to the following QC test performed:

  1. timing/gap test: measured and received within the expected time window,
  2. syntax test: data stream is structured properly,
  3. location test: check for reasonable geographic location,
  4. gross range test:  data point exceeds sensor or operator selected range,
  5. climatology test: data point falls within seasonal expectations,
  6. spike test: data point  exceeds a selected threshold relative to adjacent data points,
  7. rate of change test: excessive rise or fall, and
  8. flatline test: test for invariant value.

The flags can either be: 1-pass/good data, 2-not evaluated, 3-suspect or of high interest, 4-fail/bad data and 9-missing data. For more information on the QC tests, please visit:

Check to include the QC flags

Data Source

NOTE: Only data obtained by the GCOOS data portal can be served.

Select the data source to retrieve:

Output Format

NOTE: Only CSV format is supported to date.

Select the output format: and sorted by:


Data Call Instructions to get Observation

The following is the syntax for direct data retrieval from GCOOS repository.



{1} westlon,southlat,eastlon,northlat, where:

{2} start date formatted as YYYY-MM-DDTHH:MM:SSZ [NOTE: Contact GCOOS ( for data older that 2020-01-01]

{3} stop date formatted as YYYY-MM-DDTHH:MM:SSZ

{4} observation to retrieve

{5} data source which may either be: All, COMPS, TABS, DISL, WAVCIS, FWRI, TCOON, LUMCON, ADCP, NDBC, Scripps, CUBENet, NERRS, SCCF RECON, COAPS, NOS, ENP, LOOP, FIT, Shell

{6} desired output format. Only csv is currently supported.

{7} ascending sort order:

dates: sort the output by dates;
provider: sort the ouput by data provider, then dates; or
station: sort the output by the name of the station.

{8} QC flag:


To access the water temperature data in the repository for all the Gulf region for the period November 01, 2020 (time: 00:00:00 UTC) to November 15, 2020 (23:59:59 UTC) and sorted by dates, the call should be:,21.7,-80.5,31.0&start=2020-11-01T00:00:00Z&stop=2020-11-15T23:59:59Z&obs=water_temperature&source=All&fmt=csv&sortBy=dates&qc=on