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. Most products provide datasets from 14 days ago to today. The table below summarizes the date range for atypical products.

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-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"
  }
]