Elastic Path Commerce Cloud
PXM Catalogs/
PXM Catalog Latest Releases API for Administrators/
Get a Node

Get a Node in the Latest Release

GET Get a Node from a Catalog Release

https://api.moltin.com/pcm/catalogs/:catalogId/releases/latest/nodes/:nodeId

Returns a node from a published catalog.

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

Use releaseId to delete a specific release than the latest catalog.

You can see the parent nodes a node is associated with in the bread_crumb metadata for each node. This is useful if you want to improve how your shoppers search your store, for example. For more information, see EP PXM Catalogs API.

You can curate the products in a node. Product curation allows you to promote specific products within each of your nodes, enabling you to create unique product collections in your storefront. You can do this using a filter. See Filtering.

Parameters

Path parameters

NameRequiredTypeDescription
catalogIdRequiredstringThe unique identifier of the catalog.
releaseIdRequiredstringThe unique identifier of a published version of the catalog or latestPublished for the most recently fully published catalog. You should use latestPublished in your storefront to make sure you have the latest fully published version of a catalog.
nodeIdRequiredstringThe unique identifier of a hierarchy node.

Headers

NameRequiredTypeDescription
AuthorizationRequiredstringThe Bearer token to grant access to the API. Implicit Bearer token only returns products with live status; products with draft status are not included.

Filtering

The following table describes the supported operator and attributes when applying filters to the Get a Node from a Catalog Release endpoint:

OperatorDescriptionAttributes
inReturns the specified product IDs in the order specified in the string. Wildcards are supported. For example, /catalogs/6dff977e-a8c4-4e32-8d2c-407266dde6dd/nodes/36bb85d0-4b7c-4667-a933-a4ff714f9282/products?filter=in(id,9214719b-17fe-4ea7-896c-d61e60fc0d05,e104d541-2c52-47fa-8a9a-c4382480d97c,65daaf68-ff2e-4632-8944-370de835967d)product Id

You should add the products IDs in the order you want them to be displayed in your node. The first product ID is displayed first in the product list.

  • If you don't provide any curated_products, products are listed by their updated_at time in descending order, with the most recently updated product first.
  • If you configure curated_products for only a few products, the curated products are displayed first and the other products are displayed in the order of updated_at time.
  • You can only curate 20 products or less. You cannot have more than 20 curated products.
  • If a curated product is removed from a node, the product is also removed from the curated_products list.
  • A product that is curated has the "curated_product": true attribute displayed.

An example filter is shown below.

/catalogs/6dff977e-a8c4-4e32-8d2c-407266dde6dd/nodes/36bb85d0-4b7c-4667-a933-a4ff714f9282/products?filter=in(id,9214719b-17fe-4ea7-896c-d61e60fc0d05,e104d541-2c52-47fa-8a9a-c4382480d97c,65daaf68-ff2e-4632-8944-370de835967d)

Request Example

curl -X GET https://api.moltin.com/pcm/catalogs/aea233e7-1300-48ce-9b45-7d0c0b60dde3/releases/latest/nodes/39f96a3f-5577-473f-a263-f21fb2013469 \
     -H "Authorization: Bearer XXXX" \

Response Example

200 OK

{
    "data": {
        "id": "39f96a3f-5577-473f-a263-f21fb2013469",
        "type": "node",
        "attributes": {
            "created_at": "2021-03-08T17:50:14.629Z",
            "description": "All cooling units for food",
            "name": "Refrigerators",
            "slug": "Refrigerators-MA1",
            "curated_products": [
               "57ddfc7c-81c1-4855-88a5-2dd9d2055897",
               "42d940f9-fe26-4eed-9070-5e00234febe5",
               "2ab84aa8-232c-4199-8cc5-e1554ff58884"
            ],
            "updated_at": "2021-03-08T17:50:14.629Z",
            "published_at": "2021-04-13T02:36:16.505Z"
        },
        "meta": {
            "bread_crumb": [
              "04e748f1-83db-4013-85c8-9edfb0e1b5fa",
              "94b882fa-85de-470e-acb3-5b11358e02de",
              "a96a898b-444c-40b6-9c27-5fc74d08e685"
            ]
        },
        "relationships": {
            "children": {
                "links": {
                    "related": "/pcm/catalogs/aea233e7-1300-48ce-9b45-7d0c0b60dde3/releases/aea233e7-1300-48ce-9b45-7d0c0b60dde3/nodes/39f96a3f-5577-473f-a263-f21fb2013469/relationships/children"
                }
            },
            "hierarchy": {
                "data": {
                    "id": "0e119de2-5fb0-4bca-9b84-b3fc6c903007",
                    "type": "hierarchy"
                },
                "links": {
                    "related": "/pcm/catalogs/aea233e7-1300-48ce-9b45-7d0c0b60dde3/releases/aea233e7-1300-48ce-9b45-7d0c0b60dde3/hierarchies/0e119de2-5fb0-4bca-9b84-b3fc6c903007"
                }
            },
            "parent": {
                "data": {
                    "id": "0e119de2-5fb0-4bca-9b84-b3fc6c903007",
                    "type": "node"
                },
                "links": {
                    "related": "/pcm/catalogs/aea233e7-1300-48ce-9b45-7d0c0b60dde3/releases/aea233e7-1300-48ce-9b45-7d0c0b60dde3/nodes/0e119de2-5fb0-4bca-9b84-b3fc6c903007"
                }
            },
            "products": {
                "links": {
                    "related": "/pcm/catalogs/aea233e7-1300-48ce-9b45-7d0c0b60dde3/releases/aea233e7-1300-48ce-9b45-7d0c0b60dde3/nodes/39f96a3f-5577-473f-a263-f21fb2013469/relationships/products"
                }
            }
        }
    },
    "links": {
        "self": "/pcm/catalogs/aea233e7-1300-48ce-9b45-7d0c0b60dde3/releases/latest/nodes/39f96a3f-5577-473f-a263-f21fb2013469"
    }
}

Was this helpful?

Previous
←Get all Nodes
Next
Get a Nodeʼs Children→

Learn

Docs