Get Upward Account Hierarchy
Learn about the operation to get the full hierarchy of parent organizations for a specified account using the D&B connector.
Use the Get Upward Family tree operation to request all parent organizations — all organizations from the current organization to its global ultimate — for a current organization.
The API takes the entity URI of the organization as the input, and passes the DUNS number of the organization for which all the parent organizations are requested.
For more information, see Hierarchies and Relationships.
Request
POST {DnBConnectorUri}/getFamilyTree| Parameter | Name | Required | Details |
|---|---|---|---|
| Headers | Content-Type | Yes | Must be Content-Type: application/json. |
EnvironmentUrl | Yes | The environment url of the tenant. Example: https://dev.reltio.com | |
TenantId | Yes | Tenant ID | |
Authorization | Yes |
Reltio access token in the form | |
DnB-User | No | D&B account username or Consumer Key in Direct+. Note: Not required if you provide the D&B token.
| |
DnB-Password | No | D&B account password or Consumer Secret in Direct+. Note: Not required if you provide the D&B token.
| |
DnB-Token | No |
D&B token in the form Bearer: <<token>> Note: Not required if you provide the username and password.
| |
| Query | entityURI | Yes | Entity URI's in the form entities/XXXX |
plus | No | true or false. The default value is false. If set to true, the Direct+ based Get family tree call is started. Note: You must have a token or an account with the privileges for Direct+ API usage. Otherwise, an authentication error is raised. | |
disableNestedPartialOverride | No | Enable or disable the use of disableNestedPartialOverride option when writing to tenant. This defaults to true. | |
updateAttributeUpdateDates | No | Enable or disable the use of updateAttributeUpdateDates option for writing to customer tenant. This defaults to false. When set to true, the connector updates the singleAttributeUpdateDate for each attribute whose value has changed. For more information about the singleAttributeUpdateDate parameter, see Retrieve or modify an entity crosswalk updateDate. | |
partialOverride | No | Enable or disable the use of the partialOverride option for writing to customer tenant. This defaults to true. For more information, see Partial overrides. | |
| Body | No |
Example - Request
POST https://dev-dnbconnector.reltio.com/b2bIntegration/dnb/getFamilyTree?entityURI=entities/1QvQsDUmResponse
d1212857-07f0-44c8-bce0-f77266ce56cc:ct-ins:mahalakshmi.krishnakumar@reltio.com:1755702932935{ "success": "OK",
"message": "Family tree successful",
"entities": [entities/sbrWEPB, entities/sbrWIfR, entities/1QvQsDUm]
}