The Enhanced version of this D&B Direct product returns the ultimate parent of the requested company and all related entities. The Standard version returns only the direct line entities between the requested company and the ultimate parent.
When requesting this D&B Direct product, a valid D-U-N-S Number for a company, and the appropriate product code will be required. If this information is not available, refer to obtaining a company D-U-N-S Number for assistance. If a country code is included in the request, it will filter the results.
There are several options available when requesting this product.
1. Depth Limit: By default, this product will return all available levels of the corporate tree. An option exists to limit the number of levels returned.
2. Location Type: This option filters the corporate tree by specifying the type of entities to include. Subsidiary, Branch, Division, Headquarters, Parent, Domestic Ultimate, Global Ultimate and/or Affiliate are the possible options. Refer to the FamilyTreeMemberRoleCode field for a list of the acceptable coded values.
3. Geographic: This option allows the corporate tree to be filtered by country, state/territory, or city name.
4. Marketable Inclusions: By default, this product will exclude non marketable entities. Options exist to include entities with undeliverable mailing addresses, incomplete data, or that have specified they do not wish to be marketed to.
NOTE: The product code for Corporate Linkage - Enhanced is LNK_FF. This product may be included in the Monitoring process. However, monitoring may only be requested at the product code level (i.e. individual Business Elements may not be monitored).
The following table is an alphabetical list of the unique items delivered in this data layer. Legend: [C] = may be included in a Custom Data product; [M] = may be referenced by the Monitoring process; [M+] = Monitored using an aggregate or attribute XPath.
NOTE: This product will return a set of standard elements (e.g. D-U-N-S Number, Organization Name, Trade Styles, Family Tree Role, Primary Address, Mailing Address, Telephone Number, Fax Number, et al.) along with the business elements listed. In addition, customers who compare the following table to the Data Primer should be advised of several intentional differences.
|Direct Children Indicator||When 'true' indicates that only the count of immediate children is provided.||SOAP||REST|
|Domestic Ultimate D-U-N-S Number||The D-U-N-S Number of the highest level parent within a corporate family tree that is domiciled in the same country as the requested company. A parent is a corporation that owns more than 50% of another corporation's capital stock. A subject may be its own domestic ultimate. [C]||SOAP||REST|
|Family Tree Hierarchy Level Code||A two-position counter that indicates the number of family tree levels below the global ultimate. The hierarchy level value of the global ultimate will always be 1. Each subsidiary level below the global ultimate is incremented by one. Branch locations in a family tree will have the same hierarchy code as its associated headquarter. [C]||SOAP||REST|
|Family Tree Member Association Type||Text that defines the nature of the relationship of the linked organization to the business subject , e.g., parent, headquarter. [C]||SOAP||REST|
|Family Tree Member Business Name||Text recording a name of this organization in the specified language and/or writing script. [C]||SOAP||REST|
|Family Tree Member Country Code||The ISO Alpha 2 Country Code of the primary address of the family tree member organization. [C]||SOAP||REST|
|Family Tree Member Delist Indicator||When 'true' indicates that a business has requested its listing be removed from the D&B marketing file for privacy or other reasons. Delisting of records is performed at a company level, not at the executive name level. Records are removed from the||SOAP||REST|
|Family Tree Member D-U-N-S Number||D-U-N-S Number of the family tree member. [C]||SOAP||REST|
|Family Tree Member Location Type||Text that describes the part that the Subject plays as a member of an ownership structured family tree (e.g. headquarter, branch, division, parent, subsidiary, global ultimate, domestic ultimate).||SOAP||REST|
|Family Tree Member Mail Undeliverable (NIXIE) Indicator||When 'true' indicates that it is difficult or impossible to deliver to this address. When 'false' indicates that mails to this address can be delivered successfully.||SOAP||REST|
|Family Tree Member Marketability Indicator||When 'true' indicates that the record satisfies D&B marketability rules. When 'false' indicates that the record does not satisfy D&B marketability rules; however, there is no requirement to create this tag to represent this fact. [C]||SOAP||REST|
|Family Tree Member Street Address||Text that records the street address components as it would be presented on an address label for a member of an ownership structured family tree. This includes, but is not limited to, details such as street name, street number, building name, estate n [C]||SOAP||REST|
|Family Tree Member Territory Abbreviated Name||Text recording the shortened name of the locally governed area which forms part of a centrally governed nation to identify where the family tree member is located. [C]||SOAP||REST|
|Family Tree Member Town Name||Text recording the name of the family tree member organization's town or city recognized by the Postal Authority for delivering mail. [C]||SOAP||REST|
|Family Tree Member Trade Style Name||Text recording the name which the family tree member trades under for commercial purposes although its registered legal name used for contracts and other formal situations may be another name. [C]||SOAP||REST|
|Global Ultimate D-U-N-S Number||The D-U-N-S number of the highest level parent within a corporate family tree. A parent is a corporation that owns more than 50% of another corporation's capital stock. A subject may be its own global ultimate. [C]||SOAP||REST|
|Headquarter D-U-N-S Number||The D-U-N-S Number of the headquarters company. A headquarters is a business establishment that has branches or divisions reporting to it. [C]||SOAP||REST|
|Parent D-U-N-S Number||The D-U-N-S number of the parent company. A parent is a corporation that owns more than 50% of another corporation's capital stock; these owned companies are subsidiaries to the parent company. [C]||SOAP||REST|
|Sibling Count||The total number of affiliated subsidiaries for this parent organization (i.e. having the same hierarchy level).||SOAP||REST|
|Subject Handling Text||Text specifying the manner in which the Subject is to receive special care from D&B when it is being contacted; e.g. do not call or do not send information requests. In many cases this process was specifically requested by the Subject. [C]||SOAP||REST|
|Total Affiliate Quantity||The number of affiliated companies linked to this organization. Affiliates are related to other businesses through common ownership by the same parent organization. [C]||SOAP||REST|
|Total Branch Quantity||The number of branches linked to this headquarters location. [C]||SOAP||REST|
|Total Children Quantity||The number of subsidiaries, divisions, and branches plus the total number of affiliated subsidiaries linked to this company (i.e. subsidiaries with the same parent company). If Direct Children Indicator is set to true, this quantity is the total number of direct children; if Direct Children Indicator is set to false, this quantity is the total number of direct and indirect children. [C]||SOAP||REST|
|Total Division Quantity||The number of divisions linked to this company. [C]||SOAP||REST|
|Total Subsidiary Quantity||The number of subsidiaries linked to this parent organization. [C]||SOAP||REST|
*The links in this column provide technical characteristics for the data field characteristics of the respective business element in the XML (SOAP) or JSON (REST) response.
The list above is not presented in the order, nor manner, in which the information is packaged and delivered via the D&B Direct API. In addition to these business elements, this product will return a set of standard elements for the company requested.
The Product Availability Lookup feature may be utilized to determine if this D&B Direct product is available for a given D-U-N-S Number.
The business elements will be repeated for each entity returned on the corporate tree.
Access to this information is provided on a metered basis; and will require data layer entitlement prior to use in the production environment. A built-in feature exists to prevent duplicate billing when multiple requests with the same D-U-N-S Number and product code are submitted on the same calendar day (which is based on Eastern Standard Time [GMT-5]).
An option exists to retain the results from all successful requests for this product in a Product Request Archive, which may be retrieved without incurring additional usage charges.