Get a node

GET 
https://euwest.api.elasticpath.com/pcm/hierarchies/:hierarchyID/nodes/:nodeID

Retrieves a node from a hierarchy.

Request

Path Parameters

hierarchyID stringrequired

A unique identifier for the hierarchy.

nodeID stringrequired

A unique identifier for the node.

Responses

200

Returns a node with the following attributes.

application/json

Schema

Schema

data objectrequired
idstringrequired
The unique identifier of a node.
typestringrequired
This represents the type of resource object being returned. Always node.
Possible values: [node]
attributes objectrequired
namestring
The name of the node, such as Ranges or Refrigerators. Names must be unique among sibling nodes in the hierarchy. Otherwise, a name can be non-unique within the hierarchy and across multiple hierarchies.
descriptionstring
A description for a node.
slugstring
A slug for the node. Slugs must be unique among sibling nodes in the hierarchy. Otherwise, a slug can be non-unique within the hierarchy and across multiple hierarchies.
curated_productsstring[]
You can curate your products in your nodes product lists. Product curation allows you to promote specific products within each node in a hierarchy, enabling you to create unique product collections in your storefront.
admin_attributes object
admin_attributes are not displayed in catalogs. This means admin_attributes can only be viewed by administrators. If you want a custom attribute to be displayed in a catalog, you must add it to shopper_attributes.
admin_attributes are structured as key-value pairs. Both the keys and values are strings. You can have up to 100 keys.
property name*stringnullable
shopper_attributes object
shopper_attributes are displayed in catalogs. This means shopper_attributes can be viewed by both shoppers and administrators. If you do not want a custom attribute to be displayed in a catalog, you must add it to admin_attributes.
shopper_attributes are structured as key-value pairs. Both the keys and values are strings. You can have up to 100 keys.
property name*stringnullable
locales object
Product Experience Manager supports localization of hierarchies and nodes. If you store supports multiple languages, you can localize hierarchy and node names and descriptions.
property name* object
A three-letter language code that represents the name of language you have used.
namestring
A localized hierarchy or node name.
descriptionstring
A localized hierarchy or node description.
relationships objectrequired
Relationships allow you to move between requests. Includes links to the child nodes and products associated with a hierarchy or node.
children object
The child nodes related to the resource.
dataarray
An array of child nodes.
links object
Links allow you to move between requests.
relatedstring
A link to a related resource.
parent object
The parent node related to the resource
data object
The parent node
typestringrequired
This represents the type of resource object being returned. Always node.
Possible values: [node]
idstringrequired
The unique identifier of a node.
products object
The products related to the resource.
dataarray
An array of products.
links object
Links allow you to move between requests.
relatedstring
A link to a related resource.
meta objectrequired
sort_orderinteger
The sort order value. The node with the highest value of sort_order is displayed first. For example, a node with a sort_order value of 3 appears before a node with a sort_order value of 2. See Sorting Nodes in a hierarchy.
created_atstring<date-time>
The date and time a node is created.
Example: 2020-09-22T09:00:00
updated_atstring<date-time>
The date and time a node was updated.
Example: 2020-09-22T09:00:00
parent_namestring
The name of the parent of the node if one exists.
ownerstring
The node owner, either organization or store.
Possible values: [store, organization]
hierarchy_idstring
The unique identifier of hierarchy
breadcrumbs object[]
Breadcrumbs
Array [
idstring
The unique identifier of a hierarchy/node.
namestring
The name of the hierarchy/node.
slugstring
A slug for the hierarchy/node.
locales object
Product Experience Manager supports localization of hierarchies and nodes. If you store supports multiple languages, you can localize hierarchy and node names and descriptions.
property name* object
A three-letter language code that represents the name of language you have used.
namestring
A localized hierarchy or node name.
]

Example (auto)

{
  "data": {
    "id": "string",
    "type": "node",
    "attributes": {
      "name": "string",
      "description": "string",
      "slug": "string",
      "curated_products": [
        "string"
      ],
      "admin_attributes": {
        "cost_of_goods": "42.0",
        "charge_type": "credit card"
      },
      "shopper_attributes": {
        "cost_of_goods": "42.0",
        "charge_type": "credit card"
      },
      "locales": {}
    },
    "relationships": {
      "children": {
        "data": [
          null
        ],
        "links": {
          "related": "string"
        }
      },
      "parent": {
        "data": {
          "type": "node",
          "id": "string"
        }
      },
      "products": {
        "data": [
          null
        ],
        "links": {
          "related": "string"
        }
      }
    },
    "meta": {
      "sort_order": 0,
      "created_at": "2020-09-22T09:00:00",
      "updated_at": "2020-09-22T09:00:00",
      "parent_name": "string",
      "owner": "store",
      "hierarchy_id": "string",
      "breadcrumbs": [
        {
          "id": "string",
          "name": "string",
          "slug": "string",
          "locales": {}
        }
      ]
    }
  }
}

get-node

{
  "data": {
    "type": "node",
    "id": "9ea0de15-3347-43dd-8faa-cd32f44a04c7",
    "attributes": {
      "description": "All Ballet Shoes",
      "locales": {
        "fr-FR": {
          "name": "Chaussons de ballet",
          "description": "Toutes les chaussures de ballet"
        }
      },
      "admin_attributes": {
        "cost_of_goods": "42.0",
        "charge_type": "credit card"
      },
      "shopper_attributes": {
        "cost_of_goods": "42.0",
        "charge_type": "credit card"
      },
      "name": "Ballet Shoes",
      "slug": "ballet-shoes"
    },
    "relationships": {
      "children": {
        "data": [],
        "links": {
          "related": "/hierarchies/6183d10c-94b5-4caa-9f12-2f14cb738d41/nodes/9ea0de15-3347-43dd-8faa-cd32f44a04c7/children"
        }
      },
      "parent": {
        "data": {
          "type": "node",
          "id": "14e8e15a-7214-435d-bccb-6ae9b570d683"
        }
      },
      "products": {
        "data": [],
        "links": {
          "related": "/hierarchies/6183d10c-94b5-4caa-9f12-2f14cb738d41/nodes/9ea0de15-3347-43dd-8faa-cd32f44a04c7/products"
        }
      }
    },
    "meta": {
      "created_at": "2024-01-11T19:19:50.087Z",
      "owner": "store",
      "parent_name": "Shoes",
      "sort_order": 2,
      "updated_at": "2024-01-11T19:19:50.087Z",
      "hierarchy_id": "6183d10c-94b5-4caa-9f12-2f14cb738d41",
      "breadcrumbs": [
        {
          "id": "6183d10c-94b5-4caa-9f12-2f14cb738d41",
          "name": "Shoes",
          "slug": "shoes",
          "locales": {
            "fr-FR": {
              "name": "hierarchy 1 in French"
            }
          }
        },
        {
          "id": "9ea0de15-3347-43dd-8faa-cd32f44a04c7",
          "name": "Ballet Shoes",
          "slug": "ballet-shoes",
          "locales": {
            "fr-FR": {
              "name": "Node 1 in French"
            }
          }
        }
      ]
    }
  }
}

400

Bad request. The request failed validation.

application/json

Schema

Schema

errors undefined[]required
Array [
statusstringrequired
The HTTP response code of the error.
Example: 500
titlestringrequired
A brief summary of the error.
Example: Internal server error
detailstring
Optional additional detail about the error.
Example: An internal error has occurred.
request_idstring
Internal request ID.
Example: 00000000-0000-0000-0000-000000000000
metaobject
Additional supporting meta data for the error.
Example: {"missing_ids":["e7d50bd5-1833-43c0-9848-f9d325b08be8"]}
]

Example (auto)

{
  "errors": [
    {
      "status": "500",
      "title": "Internal server error",
      "detail": "An internal error has occurred.",
      "request_id": "00000000-0000-0000-0000-000000000000",
      "meta": {
        "missing_ids": [
          "e7d50bd5-1833-43c0-9848-f9d325b08be8"
        ]
      }
    }
  ]
}

bad-request

{
  "errors": [
    {
      "title": "Bad Request",
      "detail": "Could not parse the supplied filter",
      "status": "400"
    }
  ]
}

404

Bad Request. Not Found.

application/json

Schema

Schema

errors undefined[]required
Array [
statusstringrequired
The HTTP response code of the error.
Example: 500
titlestringrequired
A brief summary of the error.
Example: Internal server error
detailstring
Optional additional detail about the error.
Example: An internal error has occurred.
request_idstring
Internal request ID.
Example: 00000000-0000-0000-0000-000000000000
metaobject
Additional supporting meta data for the error.
Example: {"missing_ids":["e7d50bd5-1833-43c0-9848-f9d325b08be8"]}
]

Example (auto)

{
  "errors": [
    {
      "status": "500",
      "title": "Internal server error",
      "detail": "An internal error has occurred.",
      "request_id": "00000000-0000-0000-0000-000000000000",
      "meta": {
        "missing_ids": [
          "e7d50bd5-1833-43c0-9848-f9d325b08be8"
        ]
      }
    }
  ]
}

internal-server-error

{
  "errors": [
    {
      "title": "Not Found",
      "status": "404"
    }
  ]
}

500

Internal server error. There was a system failure in the platform.

application/json

Schema

Schema

errors undefined[]required
Array [
statusstringrequired
The HTTP response code of the error.
Example: 500
titlestringrequired
A brief summary of the error.
Example: Internal server error
detailstring
Optional additional detail about the error.
Example: An internal error has occurred.
request_idstring
Internal request ID.
Example: 00000000-0000-0000-0000-000000000000
metaobject
Additional supporting meta data for the error.
Example: {"missing_ids":["e7d50bd5-1833-43c0-9848-f9d325b08be8"]}
]

Example (auto)

{
  "errors": [
    {
      "status": "500",
      "title": "Internal server error",
      "detail": "An internal error has occurred.",
      "request_id": "00000000-0000-0000-0000-000000000000",
      "meta": {
        "missing_ids": [
          "e7d50bd5-1833-43c0-9848-f9d325b08be8"
        ]
      }
    }
  ]
}

internal-server-error

{
  "errors": [
    {
      "status": "500",
      "title": "Internal Server Error",
      "detail": "There was an internal server error, you can report with your request id.",
      "request_id": "635da56d-75a1-43cd-b696-7ab119756b3a"
    }
  ]
}

Authorization: http

name: bearerAuthtype: httpscheme: bearer

• csharp
• curl
• dart
• go
• http
• java
• javascript
• kotlin
• c
• nodejs
• objective-c
• ocaml
• php
• powershell
• python
• r
• ruby
• rust
• shell
• swift

• HTTPCLIENT
• RESTSHARP

var client = new HttpClient();
var request = new HttpRequestMessage(HttpMethod.Get, "https://euwest.api.elasticpath.com/pcm/hierarchies/:hierarchyID/nodes/:nodeID");
request.Headers.Add("Accept", "application/json");
request.Headers.Add("Authorization", "Bearer <token>");
var response = await client.SendAsync(request);
response.EnsureSuccessStatusCode();
Console.WriteLine(await response.Content.ReadAsStringAsync());

Request Collapse all

Base URL

https://euwest.api.elasticpath.com

Auth

Bearer Token

Parameters

hierarchyID — pathrequired

nodeID — pathrequired

ResponseClear

Click the Send API Request button above and see the response here!