---
title: "Retrieve available datasets"
method: GET
path: "/api/v1/data_distribution/datasets"
tags: ["Data Distribution"]
---

# Retrieve available datasets

`GET /api/v1/data_distribution/datasets`

## Request

- Base URL: `https://api.phys.ucalgary.ca` (the document declares no server; this is the origin it was published from)
- URL: `https://api.phys.ucalgary.ca/api/v1/data_distribution/datasets`
- Auth: none declared
- TypeScript: <https://skmtc.dev/ucalgary/apis/ucalgary-space-remote-sensing-api/docs/api/v1/data_distribution/datasets/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve information about available datasets. Filter based on parameters supplied.

Notes:
  - filtering is case insensitive
  - data level description: https://www.earthdata.nasa.gov/engage/open-data-services-and-software/data-information-policy/data-levels

## Query parameters

- `name` string, nullable
- `level` 'L0' | 'L1' | 'L1A' | 'L2' | 'L3'

## Response `200`

Dataset information

- union[]
  - union
    - Dataset
      - `name` string, required
      - `short_description` string, required
      - `long_description` string, required
      - `data_tree_url` string, required
      - `file_listing_supported` boolean, required
      - `level` string, required
      - `doi` string, nullable
      - `doi_details` string, nullable
      - `citation` string, nullable
      - `supported_libraries` string[]
      - `file_time_resolution` '1min' | '1hr' | '1day' | 'not_applicable', required
    - DatasetLegacy1: Dataset object for queries from PyAuroraX v1.3.3 or earlier
      - `name` string, required
      - `short_description` string, required
      - `long_description` string, required
      - `data_tree_url` string, required
      - `file_listing_supported` boolean, required
      - `level` string, required
      - `doi` string, nullable
      - `doi_details` string, nullable
      - `citation` string, nullable
    - DatasetLegacy2: Dataset object for queries from PyAuroraX v1.3.3 or earlier
      - `name` string, required
      - `short_description` string, required
      - `long_description` string, required
      - `data_tree_url` string, required
      - `file_listing_supported` boolean, required
      - `level` string, required
      - `doi` string, nullable
      - `doi_details` string, nullable
      - `citation` string, nullable
      - `supported_libraries` string[]

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/ucalgary/apis/ucalgary-space-remote-sensing-api.md) - [All operations](https://skmtc.dev/ucalgary/apis/ucalgary-space-remote-sensing-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ucalgary/apis/ucalgary-space-remote-sensing-api/revisions/e451a425b5eb?raw)