Get a Nodeʼs Children in the Latest Release
GET
Get a Nodeʼs Children from a Catalog Release
https://api.moltin.com/pcm/catalogs/:catalogId/releases/latest/nodes/:nodeId/relationships/children
Returns the child nodes for a node from a published catalog.
note
Currently, published catalogs are limited to the current release and two releases prior to the current release.
important
Use releaseId
to delete a specific release than the latest catalog.
You can see the parent nodes a node is associated with in the breadcrumbs
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.
Parameters
Path parameters
Name | Required | Type | Description |
---|---|---|---|
catalogId | Required | string | The unique identifier of the catalog. |
releaseId | Required | string | The unique identifier of a published version of the catalog or latest for the most recently published version. |
nodeId | Required | string | The unique identifier of a hierarchy node. |
Headers
Name | Required | Type | Description |
---|---|---|---|
Authorization | Required | string | The Bearer token to grant access to the API. Implicit Bearer token only returns products with live status; products with draft status won’t be included. |
Query parameters
Name | Required | Type | Description |
---|---|---|---|
page[limit] | Optional | string | The number of items to return per page. Minimum value is 1 . |
page[offset] | Optional | string | The number of items to offset the results by. Offset is zero-based. |
Request Example
curl -X GET https://api.moltin.com/pcm/catalogs/aea233e7-1300-48ce-9b45-7d0c0b60dde3/releases/latest/nodes/0e119de2-5fb0-4bca-9b84-b3fc6c903007/relationships/children \
-H "Authorization: Bearer XXXX" \
Response Example - EP PXM
200 OK
{
"data": [
{
"id": "e2f3372c-89ed-49ae-a9c7-0dc1888f10ec",
"type": "node",
"attributes": {
"created_at": "2021-03-05T21:48:32.874Z",
"description": "All stoves and ovens",
"name": "Ranges",
"slug": "Ranges-MA1",
"updated_at": "2021-03-05T21:48:32.874Z",
"published_at": "2021-04-13T02:36:16.505Z"
},
"meta": {
"bread_crumbs": {
"04e748f1-83db-4013-85c8-9edfb0e1b5fa": [
"e5a64eae-56c2-48cd-b8b1-f5d3be734d52",
"94b882fa-85de-470e-acb3-5b11358e02de"
],
"a96a898b-444c-40b6-9c27-5fc74d08e685": [
"e5a64eae-56c2-48cd-b8b1-f5d3be734d52"
]
},
"relationships": {
"children": {
"links": {
"related": "/pcm/catalogs/aea233e7-1300-48ce-9b45-7d0c0b60dde3/releases/aea233e7-1300-48ce-9b45-7d0c0b60dde3/nodes/e2f3372c-89ed-49ae-a9c7-0dc1888f10ec/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/e2f3372c-89ed-49ae-a9c7-0dc1888f10ec/relationships/products"
}
}
}
},
{
"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",
"updated_at": "2021-03-08T17:50:14.629Z",
"published_at": "2021-04-13T02:36:16.505Z"
},
"meta": {
"bread_crumb": [
"e5a64eae-56c2-48cd-b8b1-f5d3be734d52"
]
},
"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": {
"first": "/pcm/catalogs/aea233e7-1300-48ce-9b45-7d0c0b60dde3/releases/latest/nodes/0e119de2-5fb0-4bca-9b84-b3fc6c903007/relationships/children?page[offset]=0&page[limit]=25&",
"last": "/pcm/catalogs/aea233e7-1300-48ce-9b45-7d0c0b60dde3/releases/latest/nodes/0e119de2-5fb0-4bca-9b84-b3fc6c903007/relationships/children?page[limit]=25&page[offset]=0&",
"self": "/pcm/catalogs/aea233e7-1300-48ce-9b45-7d0c0b60dde3/releases/latest/nodes/0e119de2-5fb0-4bca-9b84-b3fc6c903007/relationships/children"
}
}
Response Example - V2
200 OK
{
"data": [
{
"id": "578c2c68-8f07-408b-a054-f5055bf91d59",
"type": "node",
"attributes": {
"created_at": "2020-08-25T14:29:52.000Z",
"description": "Browse our clothing line",
"label": "brand",
"name": "Some Cool Clothing 15983657796369708986",
"slug": "clothing",
"status": "live",
"updated_at": "2020-08-25T14:29:52.000Z"
},
"relationships": {
"children": {
"links": {
"related": "/pcm/catalogs/nodes/578c2c68-8f07-408b-a054-f5055bf91d59/relationships/children"
}
},
"parent": {
"data": {
"id": "f8c8388f-4722-51ac-b7f7-2bb3fa2f9b9f",
"type": "node"
},
"links": {
"related": "/pcm/catalogs/nodes/f8c8388f-4722-51ac-b7f7-2bb3fa2f9b9f"
}
},
"products": {
"links": {
"related": "/pcm/catalogs/nodes/578c2c68-8f07-408b-a054-f5055bf91d59/relationships/products"
}
}
}
},
{
"id": "96ca0f71-f177-450d-8c6a-4c3001c72056",
"type": "node",
"attributes": {
"created_at": "2020-08-27T22:57:11.000Z",
"description": "Browse our clothing line",
"label": "brand",
"name": "Some Cool Clothing 15985690313868111430",
"slug": "clothing",
"status": "live",
"updated_at": "2020-08-27T22:57:11.000Z"
},
"relationships": {
"children": {
"links": {
"related": "/pcm/catalogs/nodes/96ca0f71-f177-450d-8c6a-4c3001c72056/relationships/children"
}
},
"parent": {
"data": {
"id": "f8c8388f-4722-51ac-b7f7-2bb3fa2f9b9f",
"type": "node"
},
"links": {
"related": "/pcm/catalogs/nodes/f8c8388f-4722-51ac-b7f7-2bb3fa2f9b9f"
}
},
"products": {
"links": {
"related": "/pcm/catalogs/nodes/96ca0f71-f177-450d-8c6a-4c3001c72056/relationships/products"
}
}
}
},
{
"id": "0a450e04-d8a4-4f12-a800-1ad10a18d636",
"type": "node",
"attributes": {
"created_at": "2020-08-27T23:50:48.000Z",
"description": "Browse our clothing line",
"label": "brand",
"name": "Some Cool Clothing 15985721875809226256",
"slug": "clothing",
"status": "live",
"updated_at": "2020-08-27T23:50:48.000Z"
},
"relationships": {
"children": {
"links": {
"related": "/pcm/catalogs/nodes/0a450e04-d8a4-4f12-a800-1ad10a18d636/relationships/children"
}
},
"parent": {
"data": {
"id": "f8c8388f-4722-51ac-b7f7-2bb3fa2f9b9f",
"type": "node"
},
"links": {
"related": "/pcm/catalogs/nodes/f8c8388f-4722-51ac-b7f7-2bb3fa2f9b9f"
}
},
"products": {
"links": {
"related": "/pcm/catalogs/nodes/0a450e04-d8a4-4f12-a800-1ad10a18d636/relationships/products"
}
}
}
},
{
"id": "c86d6a68-383e-44ff-92e0-3441f5484f34",
"type": "node",
"attributes": {
"created_at": "2020-11-06T18:48:36.772Z",
"description": "Brand 0 description",
"label": "brand",
"name": "Brand 0",
"slug": "brand0",
"status": "live",
"updated_at": "2020-11-06T18:48:59.424Z"
},
"relationships": {
"children": {
"links": {
"related": "/pcm/catalogs/nodes/c86d6a68-383e-44ff-92e0-3441f5484f34/relationships/children"
}
},
"parent": {
"data": {
"id": "f8c8388f-4722-51ac-b7f7-2bb3fa2f9b9f",
"type": "node"
},
"links": {
"related": "/pcm/catalogs/nodes/f8c8388f-4722-51ac-b7f7-2bb3fa2f9b9f"
}
},
"products": {
"links": {
"related": "/pcm/catalogs/nodes/c86d6a68-383e-44ff-92e0-3441f5484f34/relationships/products"
}
}
}
},
{
"id": "58e0e495-f68e-46db-b030-cf7080d95cf9",
"type": "node",
"attributes": {
"created_at": "2020-11-06T18:48:36.923Z",
"description": "Brand 1 description",
"label": "brand",
"name": "Brand 1",
"slug": "brand1",
"status": "live",
"updated_at": "2020-11-06T18:48:46.123Z"
},
"relationships": {
"children": {
"links": {
"related": "/pcm/catalogs/nodes/58e0e495-f68e-46db-b030-cf7080d95cf9/relationships/children"
}
},
"parent": {
"data": {
"id": "f8c8388f-4722-51ac-b7f7-2bb3fa2f9b9f",
"type": "node"
},
"links": {
"related": "/pcm/catalogs/nodes/f8c8388f-4722-51ac-b7f7-2bb3fa2f9b9f"
}
},
"products": {
"links": {
"related": "/pcm/catalogs/nodes/58e0e495-f68e-46db-b030-cf7080d95cf9/relationships/products"
}
}
}
}
]
}