Family Tree

The samples provided are representative of what may be returned in responses. In order to provide comprehensive samples, some values were added where the actual response had null or no values.

In addition, values in both requests and responses have been "faked" or modified to protect potentially private data (e.g., phone number) where applicable. Therefore, using requests exactly as is may not return any results.

Contents

Full Family Tree

Request

GET https://plus.dnb.com/v1/familyTree/754683795

Response

{
    "transactionDetail": {
        "transactionID": "rrt-0a824544d0a4a36c5-d-ea-21463-141000245-1",
        "transactionTimestamp": "2018-03-16T18:45:16.434Z",
        "inLanguage": "en-US",
        "serviceVersion": "1"
    },
    "inquiryDetail": {
        "duns": "754683795"
    },
    "globalUltimateDuns": "804735132",
    "globalUltimateFamilyTreeMembersCount": 8,
    "familyTreeMembers": [
        {
            "duns": "804735132",
            "primaryName": "Gorman Manufacturing Company, Inc.",
            "startDate": "1985",
            "primaryAddress": {
                "addressCountry": {
                    "name": "United States",
                    "isoAlpha2Code": "US"
                },
                "addressLocality": {
                    "name": "SAN FRANCISCO"
                },
                "addressRegion": {
                    "name": "California"
                },
                "addressCounty": {
                    "name": "SAN FRANCISCO"
                },
                "postalCode": "94110",
                "streetAddress": {
                    "line1": "492 KOLLER ST"
                }
            },
            "primaryIndustryCode": {
                "usSicV4": "2752",
                "usSicV4Description": "Lithographic commercial printing"
            },
            "corporateLinkage": {
                "familytreeRolesPlayed": [
                    {
                        "description": "Global Ultimate",
                        "dnbCode": 12775
                    },
                    {
                        "description": "Domestic Ultimate",
                        "dnbCode": 12774
                    },
                    {
                        "description": "Parent/Headquarters",
                        "dnbCode": 9141
                    }
                ],
                "hierarchyLevel": 1,
                "children": [
                    {
                        "duns": "754683795"
                    },
                    {
                        "duns": "362281243"
                    }
                ]
            },
            "dunsControlStatus": {
                "isMarketable": true
            },
            "numberOfEmployees": [
                {
                    "value": 153
                }
            ],
            "financials": [
                {
                    "yearlyRevenues": [
                        {
                            "value": 24662580
                        }
                    ]
                }
            ]
        },
        {
            "duns": "362281243",
            "primaryName": "US Test Company 700",
            "primaryAddress": {
                "addressCountry": {
                    "name": "United States",
                    "isoAlpha2Code": "US"
                },
                "addressLocality": {
                    "name": "LOS ANGELES"
                },
                "addressRegion": {
                    "name": "California"
                },
                "addressCounty": {
                    "name": "LOS ANGELES"
                },
                "postalCode": "900231246",
                "streetAddress": {
                    "line1": "1073 S BOYLE AVE"
                }
            },
            "primaryIndustryCode": {
                "usSicV4": "2752",
                "usSicV4Description": "Lithographic commercial printing"
            },
            "corporateLinkage": {
                "familytreeRolesPlayed": [
                    {
                        "description": "Branch/Division",
                        "dnbCode": 9140
                    }
                ],
                "hierarchyLevel": 2,
                "parent": {
                    "duns": "804735132"
                }
            }
        },
        {
            "duns": "754683795",
            "primaryName": "KENTMORE CLOTHING (MANUFACTURING) PTY LTD",
            "startDate": "1960",
            "primaryAddress": {
                "addressCountry": {
                    "name": "Australia",
                    "isoAlpha2Code": "AU"
                },
                "addressLocality": {
                    "name": "Melbourne"
                },
                "addressRegion": {
                    "name": "AUSTRALIAN CAPITAL TERRITORY"
                },
                "postalCode": "2611",
                "streetAddress": {
                    "line1": "222 collingwood"
                }
            },
            "primaryIndustryCode": {
                "usSicV4": "5399",
                "usSicV4Description": "Ret misc general merchandise"
            },
            "tradeStyleNames": [
                {
                    "name": "KENTMORE CLOTHING",
                    "priority": 1
                }
            ],
            "corporateLinkage": {
                "familytreeRolesPlayed": [
                    {
                        "description": "Subsidiary",
                        "dnbCode": 9159
                    },
                    {
                        "description": "Domestic Ultimate",
                        "dnbCode": 12774
                    },
                    {
                        "description": "Parent/Headquarters",
                        "dnbCode": 9141
                    }
                ],
                "hierarchyLevel": 2,
                "parent": {
                    "duns": "804735132"
                },
                "children": [
                    {
                        "duns": "590124475"
                    },
                    {
                        "duns": "740260021"
                    },
                    {
                        "duns": "759006828"
                    }
                ]
            },
            "dunsControlStatus": {
                "isMarketable": true
            },
            "numberOfEmployees": [
                {
                    "value": 150
                }
            ],
            "financials": [
                {
                    "yearlyRevenues": [
                        {
                            "value": 3262580
                        }
                    ]
                }
            ]
        },
        {
            "duns": "590124475",
            "primaryName": "KENTMORE CLOTHING (MANUFACTURING) LIMITED",
            "startDate": "2002",
            "primaryAddress": {
                "addressCountry": {
                    "name": "New Zealand",
                    "isoAlpha2Code": "NZ"
                },
                "addressLocality": {
                    "name": "AUCKLAND"
                },
                "postalCode": "1010",
                "streetAddress": {
                    "line1": "L 3 1 QUEEN ST"
                }
            },
            "primaryIndustryCode": {
                "usSicV4": "2329",
                "usSicV4Description": "Mfg men's/boy's clothing"
            },
            "tradeStyleNames": [
                {
                    "name": "KENTMORE GOODFIT",
                    "priority": 1
                },
                {
                    "name": "KENTMORE CLOTHING CO",
                    "priority": 3
                },
                {
                    "name": "KENTMORE NITEWEAR",
                    "priority": 2
                }
            ],
            "corporateLinkage": {
                "familytreeRolesPlayed": [
                    {
                        "description": "Subsidiary",
                        "dnbCode": 9159
                    },
                    {
                        "description": "Domestic Ultimate",
                        "dnbCode": 12774
                    },
                    {
                        "description": "Parent/Headquarters",
                        "dnbCode": 9141
                    }
                ],
                "hierarchyLevel": 3,
                "parent": {
                    "duns": "754683795"
                },
                "children": [
                    {
                        "duns": "592493196"
                    },
                    {
                        "duns": "590325226"
                    }
                ]
            },
            "dunsControlStatus": {
                "isMarketable": true
            },
            "numberOfEmployees": [
                {
                    "value": 178
                }
            ],
            "financials": [
                {
                    "yearlyRevenues": [
                        {
                            "value": 6682580
                        }
                    ]
                }
            ]
        },
        {
            "duns": "740260021",
            "primaryName": "KENTMORE CLOTHING (MANUFACTURING) PTY LTD",
            "primaryAddress": {
                "addressCountry": {
                    "name": "Australia",
                    "isoAlpha2Code": "AU"
                },
                "addressLocality": {
                    "name": "WEST RYDE"
                },
                "addressRegion": {
                    "name": "NEW SOUTH WALES"
                },
                "postalCode": "2114",
                "streetAddress": {
                    "line1": "28 Smiths Ave"
                }
            },
            "primaryIndustryCode": {
                "usSicV4": "9999",
                "usSicV4Description": "Nonclassified establishment"
            },
            "corporateLinkage": {
                "familytreeRolesPlayed": [
                    {
                        "description": "Branch/Division",
                        "dnbCode": 9140
                    }
                ],
                "hierarchyLevel": 3,
                "parent": {
                    "duns": "754683795"
                }
            }
        },
        {
            "duns": "759006828",
            "primaryName": "KENTMORE CLOTHING (MANUFACTURING) PTY LTD",
            "primaryAddress": {
                "addressCountry": {
                    "name": "Australia",
                    "isoAlpha2Code": "AU"
                },
                "addressLocality": {
                    "name": "PERTH"
                },
                "addressRegion": {
                    "name": "WESTERN AUSTRALIA"
                },
                "postalCode": "6000",
                "streetAddress": {
                    "line1": "25 Perth Ave"
                }
            },
            "primaryIndustryCode": {
                "usSicV4": "9999",
                "usSicV4Description": "Nonclassified establishment"
            },
            "corporateLinkage": {
                "familytreeRolesPlayed": [
                    {
                        "description": "Branch/Division",
                        "dnbCode": 9140
                    }
                ],
                "hierarchyLevel": 3,
                "parent": {
                    "duns": "754683795"
                }
            }
        },
        {
            "duns": "590325226",
            "primaryName": "KENTMORE CLOTHING (MANUFACTURING) LIMITED",
            "primaryAddress": {
                "addressCountry": {
                    "name": "New Zealand",
                    "isoAlpha2Code": "NZ"
                },
                "addressLocality": {
                    "name": "CHRISTCHURCH"
                },
                "postalCode": "8001",
                "streetAddress": {
                    "line1": "5 GROSVENOR STREET"
                }
            },
            "primaryIndustryCode": {
                "usSicV4": "2341",
                "usSicV4Description": "Mfg women's/youth underwear"
            },
            "corporateLinkage": {
                "familytreeRolesPlayed": [
                    {
                        "description": "Branch/Division",
                        "dnbCode": 9140
                    }
                ],
                "hierarchyLevel": 4,
                "parent": {
                    "duns": "590124475"
                }
            }
        },
        {
            "duns": "592493196",
            "primaryName": "KENTMORE TRENDS LTD",
            "startDate": "1974",
            "primaryAddress": {
                "addressCountry": {
                    "name": "New Zealand",
                    "isoAlpha2Code": "NZ"
                },
                "addressLocality": {
                    "name": "AUCKLAND"
                },
                "postalCode": "1001",
                "streetAddress": {
                    "line1": "2 Kitchner Street"
                }
            },
            "primaryIndustryCode": {
                "usSicV4": "5137",
                "usSicV4Description": "Whol women's/child's clothing"
            },
            "corporateLinkage": {
                "familytreeRolesPlayed": [
                    {
                        "description": "Subsidiary",
                        "dnbCode": 9159
                    }
                ],
                "hierarchyLevel": 4,
                "parent": {
                    "duns": "590124475"
                }
            }
        }
    ],
    "links": {
        "last": "https://plus.dnb.com/v1/familyTree/754683795?page%5Bnumber%5D=1&page%5Bsize%5D=1000",
        "self": "https://plus.dnb.com/v1/familyTree/754683795?page%5Bnumber%5D=1&page%5Bsize%5D=1000",
        "first": "https://plus.dnb.com/v1/familyTree/754683795?page%5Bnumber%5D=1&page%5Bsize%5D=1000"
    }
}
	

Full Family Tree: Exclude Branches

Request

GET https://plus.dnb.com/v1/familyTree/754683795?exclusionCriteria=Branches

Response

{
    "transactionDetail": {
        "transactionID": "rrt-05e21e0d198365288-c-ea-24294-141847834-1",
        "transactionTimestamp": "2018-03-16T18:42:15.106Z",
        "inLanguage": "en-US",
        "serviceVersion": "1"
    },
    "inquiryDetail": {
        "duns": "754683795",
        "exclusionCriteria": "Branches"
    },
    "globalUltimateDuns": "804735132",
    "globalUltimateFamilyTreeMembersCount": 8,
    "familyTreeMembers": [
        {
            "duns": "804735132",
            "primaryName": "Gorman Manufacturing Company, Inc.",
            "startDate": "1985",
            "primaryAddress": {
                "addressCountry": {
                    "name": "United States",
                    "isoAlpha2Code": "US"
                },
                "addressLocality": {
                    "name": "SAN FRANCISCO"
                },
                "addressRegion": {
                    "name": "California"
                },
                "addressCounty": {
                    "name": "SAN FRANCISCO"
                },
                "postalCode": "94110",
                "streetAddress": {
                    "line1": "492 KOLLER ST"
                }
            },
            "primaryIndustryCode": {
                "usSicV4": "2752",
                "usSicV4Description": "Lithographic commercial printing"
            },
            "corporateLinkage": {
                "familytreeRolesPlayed": [
                    {
                        "description": "Global Ultimate",
                        "dnbCode": 12775
                    },
                    {
                        "description": "Domestic Ultimate",
                        "dnbCode": 12774
                    },
                    {
                        "description": "Parent/Headquarters",
                        "dnbCode": 9141
                    }
                ],
                "hierarchyLevel": 1,
                "children": [
                    {
                        "duns": "754683795"
                    }
                ]
            },
            "dunsControlStatus": {
                "isMarketable": true
            },
            "numberOfEmployees": [
                {
                    "value": 89
                }
            ],
            "financials": [
                {
                    "yearlyRevenues": [
                        {
                            "value": 652580
                        }
                    ]
                }
            ]
        },
        {
            "duns": "754683795",
            "primaryName": "KENTMORE CLOTHING (MANUFACTURING) PTY LTD",
            "startDate": "1960",
            "primaryAddress": {
                "addressCountry": {
                    "name": "Australia",
                    "isoAlpha2Code": "AU"
                },
                "addressLocality": {
                    "name": "Melbourne"
                },
                "addressRegion": {
                    "name": "AUSTRALIAN CAPITAL TERRITORY"
                },
                "postalCode": "2611",
                "streetAddress": {
                    "line1": "222 collingwood"
                }
            },
            "primaryIndustryCode": {
                "usSicV4": "5399",
                "usSicV4Description": "Ret misc general merchandise"
            },
            "tradeStyleNames": [
                {
                    "name": "KENTMORE CLOTHING",
                    "priority": 1
                }
            ],
            "corporateLinkage": {
                "familytreeRolesPlayed": [
                    {
                        "description": "Subsidiary",
                        "dnbCode": 9159
                    },
                    {
                        "description": "Domestic Ultimate",
                        "dnbCode": 12774
                    },
                    {
                        "description": "Parent/Headquarters",
                        "dnbCode": 9141
                    }
                ],
                "hierarchyLevel": 2,
                "parent": {
                    "duns": "804735132"
                },
                "children": [
                    {
                        "duns": "590124475"
                    }
                ]
            },
            "dunsControlStatus": {
                "isMarketable": true
            },
            "numberOfEmployees": [
                {
                    "value": 203
                }
            ],
            "financials": [
                {
                    "yearlyRevenues": [
                        {
                            "value": 8992580
                        }
                    ]
                }
            ]
        },
        {
            "duns": "590124475",
            "primaryName": "KENTMORE CLOTHING (MANUFACTURING) LIMITED",
            "startDate": "2002",
            "primaryAddress": {
                "addressCountry": {
                    "name": "New Zealand",
                    "isoAlpha2Code": "NZ"
                },
                "addressLocality": {
                    "name": "AUCKLAND"
                },
                "postalCode": "1010",
                "streetAddress": {
                    "line1": "L 3 1 QUEEN ST"
                }
            },
            "primaryIndustryCode": {
                "usSicV4": "2329",
                "usSicV4Description": "Mfg men's/boy's clothing"
            },
            "tradeStyleNames": [
                {
                    "name": "KENTMORE GOODFIT",
                    "priority": 1
                },
                {
                    "name": "KENTMORE CLOTHING CO",
                    "priority": 3
                },
                {
                    "name": "KENTMORE NITEWEAR",
                    "priority": 2
                }
            ],
            "corporateLinkage": {
                "familytreeRolesPlayed": [
                    {
                        "description": "Subsidiary",
                        "dnbCode": 9159
                    },
                    {
                        "description": "Domestic Ultimate",
                        "dnbCode": 12774
                    },
                    {
                        "description": "Parent/Headquarters",
                        "dnbCode": 9141
                    }
                ],
                "hierarchyLevel": 3,
                "parent": {
                    "duns": "754683795"
                },
                "children": [
                    {
                        "duns": "592493196"
                    }
                ]
            },
            "dunsControlStatus": {
                "isMarketable": true
            },
            "numberOfEmployees": [
                {
                    "value": 560
                }
            ],
            "financials": [
                {
                    "yearlyRevenues": [
                        {
                            "value": 97662580
                        }
                    ]
                }
            ]
        },
        {
            "duns": "592493196",
            "primaryName": "KENTMORE TRENDS LTD",
            "startDate": "1974",
            "primaryAddress": {
                "addressCountry": {
                    "name": "New Zealand",
                    "isoAlpha2Code": "NZ"
                },
                "addressLocality": {
                    "name": "AUCKLAND"
                },
                "postalCode": "1001",
                "streetAddress": {
                    "line1": "2 Kitchner Street"
                }
            },
            "primaryIndustryCode": {
                "usSicV4": "5137",
                "usSicV4Description": "Whol women's/child's clothing"
            },
            "corporateLinkage": {
                "familytreeRolesPlayed": [
                    {
                        "description": "Subsidiary",
                        "dnbCode": 9159
                    }
                ],
                "hierarchyLevel": 4,
                "parent": {
                    "duns": "590124475"
                }
            }
        }
    ],
    "links": {
        "last": "https://plus.dnb.com/v1/familyTree/754683795?exclusionCriteria=Branches&page%5Bnumber%5D=1&page%5Bsize%5D=1000",
        "self": "https://plus.dnb.com/v1/familyTree/754683795?exclusionCriteria=Branches&page%5Bnumber%5D=1&page%5Bsize%5D=1000",
        "first": "https://plus.dnb.com/v1/familyTree/754683795?exclusionCriteria=Branches&page%5Bnumber%5D=1&page%5Bsize%5D=1000"
    }
}
    

Upward Family Tree

Request

GET https://plus.dnb.com/v1/familyTreeUpward/754683795
Authorization: Bearer My Token

Response



{
    "globalUltimateDuns": "804735132",
    "familyTreeMembers": [
        {
            "duns": "804735132",
            "primaryName": "Gorman Manufacturing Company, Inc.",
            "startDate": "1985",
            "primaryAddress": {
                "addressCountry": {
                    "name": "United States",
                    "isoAlpha2Code": "US"
                },
                "addressLocality": {
                    "name": "San Francisco"
                },
                "addressRegion": {
                    "name": "California"
                },
                "addressCounty": {
                    "name": "San Francisco"
                },
                "postalCode": "94110",
                "streetAddress": {
                    "line1": "492 Koller St"
                }
            },
            "primaryIndustryCode": {
                "usSicV4": "2752",
                "usSicV4Description": "Lithographic commercial printing"
            },
            "corporateLinkage": {
                "familytreeRolesPlayed": [
                    {
                        "description": "Global Ultimate",
                        "dnbCode": 12775
                    },
                    {
                        "description": "Domestic Ultimate",
                        "dnbCode": 12774
                    },
                    {
                        "description": "Parent/Headquarters",
                        "dnbCode": 9141
                    }
                ],
                "hierarchyLevel": 1
            },
            "dunsControlStatus": {
                "isMarketable": false
            },
            "numberOfEmployees": [
                {
                    "value": 153
                }
            ],
            "financials": [
                {
                    "yearlyRevenue": [
                        {
                            "value": 22589957
                        }
                    ]
                }
            ]
        },
        {
            "duns": "754683795",
            "primaryName": "KENTMORE CLOTHING (MANUFACTURING) PTY LTD",
            "startDate": "1965",
            "primaryAddress": {
                "addressCountry": {
                    "name": "Australia",
                    "isoAlpha2Code": "AU"
                },
                "addressLocality": {
                    "name": "Melbourne"
                },
                "addressRegion": {
                    "name": "VICTORIA"
                },
                "postalCode": "2611",
                "streetAddress": {
                    "line1": "222 Collingwood Rd"
                }
            },
            "primaryIndustryCode": {
                "usSicV4": "5399",
                "usSicV4Description": "Ret misc general merchandise"
            },
            "tradeStyleNames": [
                {
                    "name": "KENTMORE CLOTHING (MANUFACTURING) PTY LTD",
                    "priority": 1
                },
                {
                    "name": "KENTMORE CLOTHING",
                    "priority": 2
                }
            ],
            "corporateLinkage": {
                "familytreeRolesPlayed": [
                    {
                        "description": "Subsidiary",
                        "dnbCode": 9159
                    },
                    {
                        "description": "Domestic Ultimate",
                        "dnbCode": 12774
                    },
                    {
                        "description": "Parent/Headquarters",
                        "dnbCode": 9141
                    }
                ],
                "hierarchyLevel": 2,
                "parent": {
                    "duns": "804735132"
                }
            },
            "dunsControlStatus": {
                "isMarketable": true
            },
            "financials": [
                {
                    "yearlyRevenue": [
                        {
                            "value": 57797053
                        }
                    ]
                }
            ]
        }
    ],
    "links": {
        "last": "https://tst.plus.dnb.com/v1/familyTreeUpward/754683795?page%5Bnumber%5D=1&page%5Bsize%5D=1000",
        "self": "https://tst.plus.dnb.com/v1/familyTreeUpward/754683795?page%5Bnumber%5D=1&page%5Bsize%5D=1000",
        "first": "https://tst.plus.dnb.com/v1/familyTreeUpward/754683795?page%5Bnumber%5D=1&page%5Bsize%5D=1000"
    },
    "transactionDetail": {
        "transactionID": "rrt-09e71b74a7dc457ac-d-ea-3017-37930886-6",
        "transactionTimestamp": "2020-03-03T13:11:03.181Z",
        "inLanguage": "en-US",
        "serviceVersion": "1"
    },
    "inquiryDetail": {
        "duns": "754683795"
    }
}