---
title: "Get a Hierarchy"
method: GET
path: "/catalog/hierarchies/{hierarchy_id}"
tags: ["Shopper Catalog API"]
---

# Get a Hierarchy

`GET /catalog/hierarchies/{hierarchy_id}`

## Request

- Base URL: `https://euwest.api.elasticpath.com`
- URL: `https://euwest.api.elasticpath.com/catalog/hierarchies/{hierarchy_id}`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/elasticpath/apis/catalogs-introduction/docs/catalog/hierarchies/:hierarchy_id/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns a hierarchy from the catalog.

If you have multiple catalog rules defined, the rule that best matches the shoppers context is used to determine which catalog to retrieve. For information about how catalog rules are matched, see [Resolving Catalog Rules](/docs/api/pxm/catalog/rules).

## Path parameters

- `hierarchy_id` string, required

## Headers

- `accept-language` string
- `EP-Channel` string
- `EP-Context-Tag` string

## Response `200`

The catalog hierarchy.

- HierarchyData: Container for hierarchies.
  - `data` Hierarchy: A category hierarchy in a catalog. Hierarchies can have parent nodes and child nodes, as well as a list of attached products.
    - `attributes` HierarchyAttributes: Resource attributes of a catalog hierarchy.
      - `created_at` string, date-time: The date and time a hierarchy is created.
      - `published_at` string, date-time, nullable: The date and time a hierarchy is published in a catalog.
      - `description` string: A description of a hierarchy.
      - `name` string: The name of a hierarchy.
      - `slug` string: A unique slug for a hierarchy.
      - `shopper_attributes` ShopperAttributes: A collection of key-value string pairs, viewable by shoppers.
      - `updated_at` string, date-time: The date and time a hierarchy was updated.
    - `id` string: A unique identifier of a hierarchy.
    - `relationships` HierarchyRelationships: Relationships to child nodes, and products.
      - `products` object: A URL to all the products associated with a hierarchy.
        - `links` RelatedLink: A URL to a related object, for example, catalog rules, hierarchies, price books, products and deltas.
          - `related` string, required: A URL to a related object, for example, catalog rules, hierarchies, price books, products and deltas.
      - `children` object: A URL to all the child products associated with a hierarchy.
        - `links` RelatedLink, required: A URL to a related object, for example, catalog rules, hierarchies, price books, products and deltas.
          - `related` string, required: A URL to a related object, for example, catalog rules, hierarchies, price books, products and deltas.
      - `nodes` object: A URL to all the nodes associated with a hierarchy.
        - `links` RelatedLink, required: A URL to a related object, for example, catalog rules, hierarchies, price books, products and deltas.
          - `related` string, required: A URL to a related object, for example, catalog rules, hierarchies, price books, products and deltas.
    - `type` string: This represents the type of object being returned. Always `hierarchy`.
    - `meta` HierarchyMeta: A hierarchy's metadata.
      - `language` string: Product Experience Manager supports localization of hierarchies. If your store supports multiple languages, you can localize hierarchy names and descriptions. This is [**three-letter language code**](https://www.iso.org/iso-639-language-code) that represents the name of the language you have used.
      - `breadcrumbs` object[]: Hierarchy Breadcrumbs
        - `id` string: The unique identifier of a hierarchy.
        - `name` string: The name of the hierarchy.
        - `slug` string: A slug for the hierarchy.
      - `has_children` boolean, nullable: Indicates whether a node has child nodes. `true` if the node has at least one child, `false` if it has none.
  - `links` Links: Links allow you to move between requests.
    - `self` string, uri-reference, nullable: Single entities use a `self` parameter with a link the specific resource.
    - `first` string, uri-reference, nullable: Always the first page.
    - `last` string, uri-reference, nullable: This is `null` if there is only one page.
    - `prev` string, uri-reference, nullable: This is `null` if there is only one page.
    - `next` string, uri-reference, nullable: This is `null` if there is only one page.

## Other responses

- `default`: The unexpected error.

---

[API](https://skmtc.dev/elasticpath/apis/catalogs-introduction.md) - [All operations](https://skmtc.dev/elasticpath/apis/catalogs-introduction/llms.txt) - [OpenAPI document](https://skmtc.dev/elasticpath/apis/catalogs-introduction/revisions/eb541d5dea51?raw)