Skip to main content

Get a Hierarchy

GET 
/catalogs/:catalog_id/releases/:release_id/hierarchies/:hierarchy_id

Returns the specified hierarchy from a published catalog.

note

Currently, published catalogs are limited to the current release and two releases prior to the current release.

Request​

Path Parameters

    catalog_id stringrequired

    The catalog ID.

    release_id stringrequired

    The unique identifier of a published release of the catalog or latestPublished for the most recently published version.

    hierarchy_id stringrequired

    The catalog hierarchy ID.

Header Parameters

    accept-language string

    The language and locale your storefront prefers. See Accept-Language.

Responses​

The catalog hierarchy.

Schema
    data object

    A category hierarchy in a catalog. Hierarchies can have parent nodes and child nodes, as well as a list of attached products.

    attributes object

    Resource attributes of a catalog hierarchy.

    created_at date-time

    The date and time a hierarchy is created.

    published_at date-timenullable

    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.

    updated_at date-time

    The date and time a hierarchy was updated.

    id string

    A unique identifier of a hierarchy.

    relationships object

    Relationships to child nodes, and products.

    products object

    A URL to all the products associated with a hierarchy.

    links object

    A URL to a related object, for example, catalog rules, hierarchies, price books, products and deltas.

    related stringrequired

    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 objectrequired

    A URL to a related object, for example, catalog rules, hierarchies, price books, products and deltas.

    related stringrequired

    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 objectrequired

    A URL to a related object, for example, catalog rules, hierarchies, price books, products and deltas.

    related stringrequired

    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 object

    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 that represents the name of the language you have used.

    links object

    Links allow you to move between requests.

    self urinullable

    Single entities use a self parameter with a link the specific resource.

    first urinullable

    Always the first page.

    last urinullable

    This is null if there is only one page.

    prev urinullable

    This is null if there is only one page.

    next urinullable

    This is null if there is only one page.

Loading...