---
title: "Retrieves the details of all accessible data subsets."
method: GET
path: "/catalogs/{catalogHrn}/dataSubsets"
tags: ["config"]
---

# Retrieves the details of all accessible data subsets.

`GET /catalogs/{catalogHrn}/dataSubsets`

Retrieves the details of all accessible data subsets which could contain the given areaId, areaIds, layerId or layerIds.

## Path parameters

- `catalogHrn` string, required

## Query parameters

- `limit` integer
- `pageToken` string
- `areas` string[]
- `layers` string[]

## Response `200`

OK

- DataSubsetsResponse — Response body for the `get data subsets` API that is useful for pagination.
  - `total` integer, required — Total number of accessible data subsets.
  - `limit` integer, required — Requested or default limit of data subsets on a page.
  - `count` integer, required — Number of data subsets present on the current page.
  - `items` DataSubsets[], required
    - `items` DataSubset[], required — List of data subsets accessible by the caller and based on different areas or layers.
      - union
        - DataSubsetAreas
          - `id` string, required
          - `name` string, required
          - `dataSubsetType` 'areas', required — Type of the data subset
          - `created` string, date-time, required
          - `areaScheme` string, required — HRN of the Area Scheme
          - `areas` string[], required
        - DataSubsetLayers
          - `id` string, required
          - `name` string, required
          - `dataSubsetType` 'layers' | 'ocm-layers' | 'nds-layers', required — Type of the data subset
          - `created` string, date-time, required
          - `layers` string[], required
  - `nextPageToken` string — An optional field which is present when there is another page with more data subsets that should be queried. The string value should be used in the query parameter of the new request to query the next page.

## Other responses

- `401` — Unauthorized
- `403` — Forbidden - A catalog with the specified HRN doesn't exist or access to this catalog is forbidden.

---

[API](https://skmtc.dev/here/apis/query-api-v1.md) · [All operations](https://skmtc.dev/here/apis/query-api-v1/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/here/query-api-v1/revisions/30e5d2645407/schema)