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

# Retrieves the details of all accessible subsets.

`GET /catalogs/{catalogHrn}/subsets`

> **Deprecated.**

This endpoint is deprecated. Use **/catalogs/{catalogHrn}/dataSubsets** instead. **BETA** Retrieves the details of all accessible subsets which contain the given areaId or areaIds.

## Path parameters

- `catalogHrn` string, required

## Query parameters

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

## Response `200`

OK

- SubsetsResponse — **BETA** Response body for the `get subsets` API that is useful for pagination.
  - `total` integer, required — Total number of accessible subsets.
  - `limit` integer, required — Requested or default limit of subsets on a page.
  - `count` integer, required — Number of subsets present on the current page.
  - `items` Subsets[], required
    - `items` Subset[], required — List of subsets accessible by the caller and based on different areas.
      - `id` string, required — Immutable ID that refers to the subset.
      - `hrn` string, required — HERE Resource Name (HRN) for the subset.
      - `name` string, required — Short name for the subset.
      - `areas` string[], required — Various areas covered in the subset.
      - `created` string, required — Creation date and time.
  - `nextPageToken` string — An optional field which is present when there is another page with more 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)