Access Support Service

Overview

The National Centers for Environmental Information (NCEI) Common Access Support Service provides a RESTful application programming interface (API) to discover metadata and attributes about datasets based on a set of parameters to the /v4/datasets URL. The NCEI Common Access Support Service is only available via HTTP Strict Transport Security ( HSTS specification ) following Federal government HTTPS policy . Requests use HTTP 1.1 GET method specification request and results are formatted as JavaScript Object Notation ( JSON specification ) that contains a results array property.

Request Endpoint

The NCEI Access Support Service queries use HTTP 1.1 GET method specification request and the endpoint is located off the base URL at .../access/services/support/v4.

Datasets Endpoint

Below is the full URL endpoint to view all available datasets in JSON format.

Request Endpoint Parameter

The NCEI Access Support Service endpoint allows one parameter to select and retrieve metadata from the requested dataset.

Parameters: {datasetId}

Dataset Id

The dataset id parameter specifies the dataset being passed to the service.

Example URL with datasetID Parameter

Below is a full URL example of an API request to the NCEI Common Access Support Service. The URL includes the request endpoint and the request endpoint parameter that is being passed to the service. A successful response will open raw data in the browser.

Example Request URL for the default CSV file type: