Datasets

This endpoint provides a list of available datasets for a product. Each dataset in the response provides a URL where the content can be downloaded and an expiration time for the URL.

Request Structure

GET /products/{product-name}/datasets

Optional Parameters

The default response contains all available datasets for today’s UTC date. Use the date parameter to obtain datasets for a different date. An empty list is returned when no datasets are available.

Name Type Description Accepted Values / Range Example
date string UTC date (ISO8601) any valid date 2017-01-01

Dataset availability differs by product and time of the request. The table below provides the typical date range for each product.

Product Earliest Date Latest Date
skywise-conus-24hr-precipitation-analysis 2-3 days ago Today
skywise-global-24hr-precipitation-analysis 2-3 days ago Today
skywise-conus-surface-analysis 14 days ago Today
skywise-global-surface-analysis 14 days ago Today
skywise-global-surface-forecast 14 days ago Today
skywise-global-daily-summary 1979-01-01 2015-12-31

Request Examples

See Headers for request header details.

Analysis Datasets

$ curl -X GET http://data-transfer.api.wdtinc.com/products/skywise-global-surface-analysis/datasets \
       -n -H "Accept: application/vnd.wdt+json; version=1"

Forecast Datasets

$ curl -X GET http://data-transfer.api.wdtinc.com/products/skywise-global-surface-forecast/datasets \
       -n -H "Accept: application/vnd.wdt+json; version=1"

Response Examples

See Status Codes for response code details.

Analysis Datasets

HTTP/1.1 200 OK
[
  {
    "name": "SkyWise_Global_SurfaceAnalysis_Hourly_20170101-000000.nc",
    "validTime": "2017-01-01T00:00:00Z",
    "downloadUrl": "https://.../SkyWise_Global_SurfaceAnalysis_Hourly_20170101-000000.nc",
    "expirationTime": "2017-01-02T00:00:00Z"
  },
  {
    "name": "SkyWise_Global_SurfaceAnalysis_Hourly_20170101-010000.nc",
    "validTime": "2017-01-01T01:00:00Z",
    "downloadUrl": "https://.../SkyWise_Global_SurfaceAnalysis_Hourly_20170101-010000.nc",
    "expirationTime": "2017-01-02T01:00:00Z"
  },
  {
    "name": "SkyWise_Global_SurfaceAnalysis_Hourly_20170101-020000.nc",
    "validTime": "2017-01-01T02:00:00Z",
    "downloadUrl": "https://.../SkyWise_Global_SurfaceAnalysis_Hourly_20170101-020000.nc",
    "expirationTime": "2017-01-02T02:00:00Z"
  }
]

Forecast Datasets

HTTP/1.1 200 OK
[
  {
    "name": "SkyWise_Global_SurfaceForecast_Hourly_20170101-000000-f0000000.nc",
    "initTime": "2017-01-01T00:00:00Z",
    "validTime": "2017-01-01T00:00:00Z",
    "downloadUrl": "https://.../SkyWise_Global_SurfaceForecast_Hourly_20170101-000000-f0000000.nc",
    "expirationTime": "2017-01-02T00:00:00Z"
  },
  {
    "name": "SkyWise_Global_SurfaceForecast_Hourly_20170101-000000-f0010000.nc",
    "initTime": "2017-01-01T00:00:00Z",
    "validTime": "2017-01-01T01:00:00Z",
    "downloadUrl": "https://.../SkyWise_Global_SurfaceForecast_Hourly_20170101-000000-f0010000.nc",
    "expirationTime": "2017-01-02T01:00:00Z"
  },
  {
    "name": "SkyWise_Global_SurfaceForecast_Hourly_20170101-000000-f0020000.nc",
    "initTime": "2017-01-01T00:00:00Z",
    "validTime": "2017-01-01T02:00:00Z",
    "downloadUrl": "https://.../SkyWise_Global_SurfaceForecast_Hourly_20170101-000000-f0020000.nc",
    "expirationTime": "2017-01-02T02:00:00Z"
  }
]