Get Hierarchies
post
/config/sim/v1/hierarchy/getHierarchy
Gets a list of hierarchies in a given organization
Request
Supported Media Types
- application/json
- multipart/form-data
A request body
Root Schema : HierachyGetRequestBody
Type:
objectThe input Body model that needs to be given.
Show Source
-
include:
string
Objects included in response
-
includeAll:
string
This can take 2 values: basic or detailed. If 'basic' is specified, The response contains all the properties of the object except
Ext values. If 'detailed' is specified, The response contains all the properties of the object. Example:detailed -
languages:
string
If specified, limits translated strings returned
-
limit:
integer
If using paging, number of results returned in this page.
-
offset:
integer
Starting resource record index. Not required if paging parameters are not supported
-
orderBy:
string
Sorts the response by the specified field name and sort order.
-
searchCriteria:
string
Search criteria to filter results based on field value
Response
Supported Media Types
- application/json
200 Response
A collection of hierarchies in organization.
Root Schema : Hierarchy
Type:
objectModel for a Hierarchy Object
Show Source
-
hierStrucId(required):
integer
Hierarchy Structure Id of the node of the hierarchy. Excluded by default.Example:
1 -
hierType(required):
string
Type of Hierarchy NodeExample:
Default -
hierUnitId(required):
integer
Hierarchy Unit Id of the root node of the hierarchyExample:
1 -
hierUnitObjNum(required):
integer
Object number of the hierarchy unit.Example:
1 -
locRef(required):
string
Location Reference of the node (Only valid for hierType = Location). Excluded by default.Example:
Location-1 -
name(required):
object name
Hierarchy Name
-
nodes(required):
array nodes
An array of Hierarchy.
-
parentHierStrucId(required):
integer
Hierarchy Structure Id of the parent node. Excluded by default.Example:
0 -
parentHierUnitId(required):
integer
Hierarchy unit id of the parent nodeExample:
0 -
parentLocRef(required):
string
Location Reference of the parent node (Only valid for hierType = RVC). Excluded by default.Example:
Location-1 -
simphonyType(required):
string
Determines the simphony type (essentials or standard) of organization. This field is present in the first object of the response and searching using this field is not allowed.Example:
Essentials
Nested Schema : name
Type:
objectHierarchy Name
Example:
{"en-US":"Enterprise", "de-DE": "Enterprise", "ar-AR": "??????????????"}Nested Schema : nodes
Type:
arrayAn array of Hierarchy.
Show Source
-
Array of:
object Hierarchy
Model for a Hierarchy Object
400 Response
400 Bad Request
Root Schema : ErrorDetails
Type:
objectResponse body when the request returns an error.
Show Source
-
detail(required):
string
A short, human-readable summary of the problem.Example:
Specified Data is invalid -
errorDetails(required):
string
A human-readable explanation specific to this occurrence of the problem.Example:
Entity Does Not Exist -
o:errorCode(required):
integer
Error code of the problemExample:
55223 -
status(required):
integer
HTTP status code.Example:
400 -
title(required):
string
A short, human-readable summary of the problem type.Example:
VALIDATION ERROR -
type(required):
string
A URI reference that identifies the problem type. When this member is not present, its value is assumed to be "about:blank".Example:
http://www.abc.org/xyz.html
404 Response
404 Requested resource not found