Getting Started


Currently the Cal-Adapt API does not require authentication. You do not need to sign up for a key to start working with the API. We plan to maintain the current level of open access to support a wide range of users. However, authentication may be implemented in the future to support throttled access for selected applications.

Entry Point

The entry point or API root is a starting point that provides an overview of all available data in the API. The entry point for the Cal-Adapt API is at


Browsable API View

When you visit the above entry point in a browser, you will see an easy to read, browsable view of the Cal-Adapt API. The browsable API view provides a quick overview of available data resources in the API and the URLs to access these data resources. This makes it easier and convenient to test requests and their returns in a web browser.


The Cal-Adapt API supports the following representations or data formats listed with their content type followed by format identifier:

  • Raster and vector data
    • Browsable API view text/html api
    • JavaScript Object Notation application/json json
  • Raster data only
    • Comma Separated Values text/csv csv
    • Zipped GeoTIFF application/zip
  • Vector data only
    • GeoJSON application/vnd.geo+json geojson
    • Keyhole Markup Language application/ kml
    • Zipped KML files application/ kmz

The HTTP Accept header is used in performing content negotiation. The server will return JSON when a client does not specify. The following command confirms the Contenty-Type: application/json header in the response.

curl -IH 'Accept: application/json'
HTTP/1.1 200 OK
Vary: Accept
Content-Type: application/json

Or, HTML which returns the browsable API page.

curl -IH 'Accept: text/html'
HTTP/1.1 200 OK
Vary: Accept
Content-Type: text/html; charset=utf-8

If necessary, content negotiation can be overridden by adding the format query parameter to the URL like