Flexible Hierarchy Snapshot Response

Output representation of the captured structure of a flexible hierarchy snapshot, lazily loaded one context node at a time.

JSON Example

1{
2  "contextNode": {
3    "id": "0HNxx0000004N02EAM",
4    "predecessorNodeId": "0HNxx0000004N01EAM",
5    "referenceRecordId": "001xx000003GZ40AAG",
6    "referenceRecordType": "Account",
7    "referenceRecordTypeLabel": "Account",
8    "role": "Region",
9    "totalChildrenCount": 4,
10    "displayValues": [
11      {
12        "fieldName": "Name",
13        "fieldLabel": "Account Name",
14        "fieldType": "String",
15        "fieldValue": "EMEA Region",
16        "isLookup": false,
17        "isNameField": true
18      }
19    ],
20    "summaryValues": []
21  },
22  "ancestorNodes": [
23    {
24      "id": "0HNxx0000004N01EAM",
25      "referenceRecordId": "001xx000003GZ39AAG",
26      "referenceRecordType": "Account",
27      "referenceRecordTypeLabel": "Account",
28      "role": "Root",
29      "totalChildrenCount": 2,
30      "displayValues": [],
31      "summaryValues": []
32    }
33  ],
34  "ancestorRelations": [
35    {
36      "id": "0HRxx0000004R01EAM",
37      "predecessorNodeId": "0HNxx0000004N01EAM",
38      "successorNodeId": "0HNxx0000004N02EAM",
39      "displayValues": []
40    }
41  ],
42  "childNodes": [
43    {
44      "id": "0HNxx0000004N03EAM",
45      "predecessorNodeId": "0HNxx0000004N02EAM",
46      "referenceRecordId": "001xx000003GZ41AAG",
47      "referenceRecordType": "Account",
48      "referenceRecordTypeLabel": "Account",
49      "role": "Country",
50      "totalChildrenCount": 0,
51      "displayValues": [],
52      "summaryValues": []
53    }
54  ],
55  "childRelations": [
56    {
57      "id": "0HRxx0000004R02EAM",
58      "predecessorNodeId": "0HNxx0000004N02EAM",
59      "successorNodeId": "0HNxx0000004N03EAM",
60      "displayValues": []
61    }
62  ],
63  "pathToRoot": [
64    "0HNxx0000004N02EAM",
65    "0HNxx0000004N01EAM"
66  ],
67  "pagination": {
68    "hasNext": false,
69    "offset": 0,
70    "pageSize": 1000,
71    "totalChildNodes": 4
72  },
73  "hierarchyConfiguration": {
74    "id": "0RGDxx0000004GD1EAM",
75    "relationshipGraphDefinitionVersion": "1",
76    "entityDisplayFields": [
77      {
78        "entityName": "Account",
79        "entityLabel": "Account",
80        "graphViewFields": [
81          "Name"
82        ],
83        "gridViewFields": [
84          "Name"
85        ]
86      }
87    ],
88    "relationshipList": [
89      {
90        "parentNodeEntityApiName": "Account",
91        "childNodeEntityApiName": "Account"
92      }
93    ],
94    "summaryRollupList": []
95  },
96  "snapshotMetadata": {
97    "hierarchyId": "0H1xx0000004FH1EAM",
98    "capturedAt": "2026-07-20T08:27:26.000Z",
99    "locale": "en_US",
100    "navigationPolicy": "Standard",
101    "schemaVersion": 1,
102    "totalNodes": 16,
103    "totalRelationshipCount": 15,
104    "captureContext": {
105      "accessModel": "reResolveInUserContext",
106      "runAsIntegrationUser": false
107    }
108  },
109  "responseStatus": {
110    "statusCode": 200,
111    "message": "Snapshot retrieved."
112  }
113}

Properties

Property Name Type Description Filter Group and Version Available Version
ancestorNodes Flexible Hierarchy Snapshot Node Details[] Context node's ancestor nodes, ordered from the immediate parent up to the root. Big, 68.0 68.0
ancestorRelations Flexible Hierarchy Snapshot Relationship Details[] Parent-child connections along the ancestor chain. Big, 68.0 68.0
childNodes Flexible Hierarchy Snapshot Node Details[] Paginated list of the context node's direct children. Big, 68.0 68.0
childRelations Flexible Hierarchy Snapshot Relationship Details[] Parent-child connections from the context node to the returned child nodes. Big, 68.0 68.0
contextNode Flexible Hierarchy Snapshot Node Details Node that's specified in the request. This is the node identified by nodeId, or the snapshot's root node when nodeId isn't specified. Big, 68.0 68.0
hierarchyConfiguration Flexible Hierarchy Snapshot Hierarchy Configuration Details Frozen configuration for the snapshot, including entity display fields, relationships, and rollup definitions. Big, 68.0 68.0
pagination Flexible Hierarchy Pagination Details Pagination details for the childNodes array. Big, 68.0 68.0
pathToRoot String[] Node IDs from the context node up to the root, inclusive, ordered with the context node first. Big, 68.0 68.0
responseStatus Flexible Hierarchy Status HTTP status code and message for the API request. Big, 68.0 68.0
snapshotMetadata Flexible Hierarchy Snapshot Metadata Details Metadata about the snapshot, including capture time, schema version, and provenance. Big, 68.0 68.0