Corporate Linkage - Enhanced

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.

Requirements & Options

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).

Business Elements

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.

Name Description XML* JSON*
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.

Additional Details

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.

Related Topics

Corporate Linkage - Standard.

Technical Specification

For details on how to obtain this data layer, please refer to the Linkage.OrderProduct (SOAP) or Linkage.OrderProduct (REST) page.


Product History

Back to Top