Entity Screening API via Dow Jones

The samples provided are representative of what can be included in requests or will be returned in responses. In order to provide comprehensive samples, values may have been added for the sole purpose of these examples and may be null or empty in the actual API responses.

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.

Content

Search by DUNS

Request


https://plus.dnb.com/v1/screening/dowjones/search?duns=804735132

Response


{
    "transactionDetail": {
        "transactionID": "rrt-0b44eb1cd4360a0a2-b-ea-23029-43073019-1",
        "transactionTimestamp": "2019-33-11T20:33:47.956Z",
        "inLanguage": "en-US"
    },
    "inquiryDetail": {
        "duns": "804735132",
        "entityType": "E"
    },
    "candidatesMatchedQuantity": 1,
    "candidatesStartSequenceNumber": 0,
    "candidatesEndSequenceNumber": 1,
    "searchCandidates": [
        {
            "primaryName": "Gorman Corporation",
            "countryISOAlpha2Code": "US",
            "entityType": "ENTITY",
            "entityID": "847530",
            "mostRecentRevisionDate": "2019-09-27 13:48:27.490",
            "riskIcons": [
                {
                    "code": "OOL"
                },
                {
                    "code": "AM"
                }
            ],
            "title": "SEC - Administrative Proceedings",
            "isSubsidiary": false,
            "gender": null,
            "datesOfBirth": null,
            "matchedName": null,
            "matchedDateOfBirth": null,
            "matchedCountries": [
                {
                    "countryISOAlpha2Code": "US",
                    "countryType": "Country of Registration"
                },
                {
                    "countryISOAlpha2Code": "US",
                    "countryType": "Country of Affiliation"
                }
            ],
            "matchQuality": {
                "matchScore": "1.0",
                "searchPrecision": null
            }
        }
    ]
}

Search by Entity Name

Request


https://plus.dnb.com/v1/screening/dowjones/search?searchType=orgname&organizationName=Gorman Manufacturing&candidatesStartSequenceNumber=1&candidatesEndSequenceNumber=3

Response


{
    "transactionDetail": {
        "transactionID": "rrt-05ae0a38171a74082-b-ea-23044-42318456-1",
        "transactionTimestamp": "2019-37-11T20:37:48.562Z",
        "inLanguage": "en-US"
    },
    "inquiryDetail": {
        "searchType": "orgname",
        "organizationName": "Gorman Manufacturing",
        "candidatesStartSequenceNumber": 1,
        "candidatesEndSequenceNumber": 3
    },
    "candidatesMatchedQuantity": 3,
    "candidatesStartSequenceNumber": 1,
    "candidatesEndSequenceNumber": 3,
    "searchCandidates": [
        {
            "primaryName": "Gorman Manufacturing Company",
            "countryISOAlpha2Code": "US",
            "entityType": "ENTITY",
            "entityID": "12030881",
            "mostRecentRevisionDate": "2018-02-19 12:15:48.767",
            "riskIcons": [
                {
                    "code": "SOC"
                }
            ],
            "title": "State Owned Company",
            "isSubsidiary": true,
            "gender": null,
            "datesOfBirth": null,
            "matchedName": {
                "name": "Gorman Manufacturing Company",
                "nameType": "Primary Name"
            },
            "matchedDateOfBirth": null,
            "matchedCountries": [
                {
                    "countryISOAlpha2Code": "US",
                    "countryType": "Country of Registration"
                },
                {
                    "countryISOAlpha2Code": "US",
                    "countryType": "Country of Current Ownership"
                },
                {
                    "countryISOAlpha2Code": "US",
                    "countryType": "Country of Past Ownership"
                }
            ],
            "matchQuality": {
                "matchScore": "0.76",
                "searchPrecision": {
                    "precision": "NEAR",
                    "hasLinguisticVariations": "false",
                    "hasNonLinguisticVariations": "true",
                    "hasStructuralVariations": "true"
                }
            }
        },
        {
            "primaryName": "Gorman Telecommunications Company Limited",
            "countryISOAlpha2Code": "SY",
            "entityType": "ENTITY",
            "entityID": "10526321",
            "mostRecentRevisionDate": "2019-07-16 02:29:23.007",
            "riskIcons": [
                {
                    "code": "SOR"
                },
                {
                    "code": "SOC"
                }
            ],
            "title": "State Owned Company",
            "isSubsidiary": false,
            "gender": null,
            "datesOfBirth": null,
            "matchedName": {
                "name": "Gorman Company for Manufacturing ISDN Terminals and WLL Equipments",
                "nameType": "Spelling Variation"
            },
            "matchedDateOfBirth": null,
            "matchedCountries": [
                {
                    "countryISOAlpha2Code": "SY",
                    "countryType": "Country of Current Ownership"
                },
                {
                    "countryISOAlpha2Code": "SY",
                    "countryType": "Country of Registration"
                },
                {
                    "countryISOAlpha2Code": "SY",
                    "countryType": "Sanctioned Region"
                }
            ],
            "matchQuality": {
                "matchScore": "0.76",
                "searchPrecision": {
                    "precision": "NEAR",
                    "hasLinguisticVariations": "false",
                    "hasNonLinguisticVariations": "true",
                    "hasStructuralVariations": "true"
                }
            }
        }
    ]
}

Search by Person Name

Request


https://plus.dnb.com/v1/screening/dowjones/search?searchType=personname&familyName=John&candidatesStartSequenceNumber=0&candidatesEndSequenceNumber=2

Response


{
    "transactionDetail": {
        "transactionID": "rrt-03c20895fb940a826-c-ea-22920-43433582-1",
        "transactionTimestamp": "2019-36-11T20:36:58.396Z",
        "inLanguage": "en-US"
    },
    "inquiryDetail": {
        "searchType": "personname",
        "familyName": "John",
        "candidatesStartSequenceNumber": 0,
        "candidatesEndSequenceNumber": 2
    },
    "candidatesMatchedQuantity": 835,
    "candidatesStartSequenceNumber": 0,
    "candidatesEndSequenceNumber": 2,
    "searchCandidates": [
        {
            "primaryName": "John, Smith",
            "countryISOAlpha2Code": "NG",
            "entityType": "PERSON",
            "entityID": "31269651",
            "mostRecentRevisionDate": "2019-05-16 09:20:55.257",
            "riskIcons": [
                {
                    "code": "SI-LT"
                }
            ],
            "title": "",
            "isSubsidiary": false,
            "gender": "MALE",
            "datesOfBirth": [
                {
                    "year": "1983",
                    "month": null,
                    "day": null
                },
                {
                    "year": "1984",
                    "month": null,
                    "day": null
                }
            ],
            "matchedName": {
                "name": "AbiodunJohn",
                "nameType": "Also Known As"
            },
            "matchedDateOfBirth": null,
            "matchedCountries": [
                {
                    "countryISOAlpha2Code": "NG",
                    "countryType": "Citizenship"
                },
                {
                    "countryISOAlpha2Code": "NG",
                    "countryType": "Resident of"
                },
                {
                    "countryISOAlpha2Code": "US",
                    "countryType": "Country of Reported Allegation"
                },
                {
                    "countryISOAlpha2Code": "US",
                    "countryType": "Resident of"
                }
            ],
            "matchQuality": {
                "matchScore": "1.0",
                "searchPrecision": {
                    "precision": "PRECISE",
                    "hasLinguisticVariations": "false",
                    "hasNonLinguisticVariations": "false",
                    "hasStructuralVariations": "false"
                }
            }
        },
        {
            "primaryName": "Aziz, John",
            "countryISOAlpha2Code": "PK",
            "entityType": "PERSON",
            "entityID": "43152001",
            "mostRecentRevisionDate": "2018-05-08 14:07:13.677",
            "riskIcons": [
                {
                    "code": "SI"
                }
            ],
            "title": "",
            "isSubsidiary": false,
            "gender": "MALE",
            "datesOfBirth": [],
            "matchedName": {
                "name": "John",
                "nameType": "Low Quality AKA"
            },
            "matchedDateOfBirth": null,
            "matchedCountries": [
                {
                    "countryISOAlpha2Code": "PK",
                    "countryType": "Resident of"
                },
                {
                    "countryISOAlpha2Code": "PK",
                    "countryType": "Citizenship"
                },
                {
                    "countryISOAlpha2Code": "PK",
                    "countryType": "Country of Reported Allegation"
                }
            ],
            "matchQuality": {
                "matchScore": "1.0",
                "searchPrecision": {
                    "precision": "PRECISE",
                    "hasLinguisticVariations": "false",
                    "hasNonLinguisticVariations": "false",
                    "hasStructuralVariations": "false"
                }
            }
        }
    ]
}

Search by ID

Request


https://plus.dnb.com/v1/screening/dowjones/search?searchType=id&id=AB100089&idType=1&entityType=E

Response


{
    "transactionDetail": {
        "transactionID": "rrt-0b44eb1cd4360a0a2-b-ea-23029-43073019-1",
        "transactionTimestamp": "2019-33-11T20:33:47.956Z",
        "inLanguage": "en-US"
    },
    "inquiryDetail": {
        "searchType": "id",
        "idType": 1,
        "id": "AB100089",
        "entityType": "E"
    },
    "candidatesMatchedQuantity": 1,
    "candidatesStartSequenceNumber": 0,
    "candidatesEndSequenceNumber": 1,
    "searchCandidates": [
        {
            "primaryName": "Gorman Corporation",
            "countryISOAlpha2Code": "US",
            "entityType": "ENTITY",
            "entityID": "8475301",
            "mostRecentRevisionDate": "2019-09-27 13:48:27.490",
            "riskIcons": [
                {
                    "code": "OOL"
                },
                {
                    "code": "AM"
                }
            ],
            "title": "SEC - Administrative Proceedings",
            "isSubsidiary": false,
            "gender": null,
            "datesOfBirth": null,
            "matchedName": null,
            "matchedDateOfBirth": null,
            "matchedCountries": [
                {
                    "countryISOAlpha2Code": "US",
                    "countryType": "Country of Registration"
                },
                {
                    "countryISOAlpha2Code": "US",
                    "countryType": "Country of Affiliation"
                }
            ],
            "matchQuality": {
                "matchScore": "1.0",
                "searchPrecision": null
            }
        }
    ]
}

Search by Name

Request


https://plus.dnb.com/v1/screening/dowjones/search?searchType=name&name=Gorman Manufacturing&candidatesStartSequenceNumber=1&candidatesEndSequenceNumber=3


Response


{
    "transactionDetail": {
        "transactionID": "rrt-05ae0a38171a74082-b-ea-23044-42318456-1",
        "transactionTimestamp": "2019-37-11T20:37:48.562Z",
        "inLanguage": "en-US"
    },
    "inquiryDetail": {
        "searchType": "name",
        "name": "Gorman Manufacturing",
        "candidatesStartSequenceNumber": 1,
        "candidatesEndSequenceNumber": 3
    },
    "candidatesMatchedQuantity": 3,
    "candidatesStartSequenceNumber": 1,
    "candidatesEndSequenceNumber": 3,
    "searchCandidates": [
        {
            "primaryName": "Gorman Manufacturing Company",
            "countryISOAlpha2Code": "US",
            "entityType": "ENTITY",
            "entityID": "12030881",
            "mostRecentRevisionDate": "2018-02-19 12:15:48.767",
            "riskIcons": [
                {
                    "code": "SOC"
                }
            ],
            "title": "State Owned Company",
            "isSubsidiary": true,
            "gender": null,
            "datesOfBirth": null,
            "matchedName": {
                "name": "Gorman Manufacturing Company",
                "nameType": "Primary Name"
            },
            "matchedDateOfBirth": null,
            "matchedCountries": [
                {
                    "countryISOAlpha2Code": "US",
                    "countryType": "Country of Registration"
                },
                {
                    "countryISOAlpha2Code": "US",
                    "countryType": "Country of Current Ownership"
                },
                {
                    "countryISOAlpha2Code": "US",
                    "countryType": "Country of Past Ownership"
                }
            ],
            "matchQuality": {
                "matchScore": "0.76",
                "searchPrecision": {
                    "precision": "NEAR",
                    "hasLinguisticVariations": "false",
                    "hasNonLinguisticVariations": "true",
                    "hasStructuralVariations": "true"
                }
            }
        },
        {
            "primaryName": "Gorman Telecommunications Company Limited",
            "countryISOAlpha2Code": "SY",
            "entityType": "ENTITY",
            "entityID": "10526321",
            "mostRecentRevisionDate": "2019-07-16 02:29:23.007",
            "riskIcons": [
                {
                    "code": "SOR"
                },
                {
                    "code": "SOC"
                }
            ],
            "title": "State Owned Company",
            "isSubsidiary": false,
            "gender": null,
            "datesOfBirth": null,
            "matchedName": {
                "name": "Gorman Company for Manufacturing ISDN Terminals and WLL Equipments",
                "nameType": "Spelling Variation"
            },
            "matchedDateOfBirth": null,
            "matchedCountries": [
                {
                    "countryISOAlpha2Code": "SY",
                    "countryType": "Country of Current Ownership"
                },
                {
                    "countryISOAlpha2Code": "SY",
                    "countryType": "Country of Registration"
                },
                {
                    "countryISOAlpha2Code": "SY",
                    "countryType": "Sanctioned Region"
                }
            ],
            "matchQuality": {
                "matchScore": "0.76",
                "searchPrecision": {
                    "precision": "NEAR",
                    "hasLinguisticVariations": "false",
                    "hasNonLinguisticVariations": "true",
                    "hasStructuralVariations": "true"
                }
            }
        }
    ]
}

Get Data

Request


https://plus.dnb.com/v1/screening/dowjones/data/1203088?adverseMediaArticleType=RCA&includePrimaryName=false

Response


{
    "transactionDetail": {
        "transactionID": "rrt-0a7fa8f7f5552207e-b-ea-22975-43451292-1",
        "transactionTimestamp": "2019-38-11T20:38:32.692Z",
        "inLanguage": "en-US"
    },
    "inquiryDetail": {
        "entityID": "12030881",
        "adverseMediaArticleType": "RCA",
        "includePrimaryName": false
    },
    "matchedProfiles": [
        {
            "enityID": "12030881",
            "entityType": "Entity",
            "isSubsidiary": true,
            "organizationNames": [
                {
                    "nameType": "Primary Name",
                    "name": "Gorman Manufacturing",
                    "nameSuffix": "Company",
                    "nameGroups": [
                        {
                            "nameType": "Original Script Name",
                            "nativeScriptName": {
                                "name": "?????? ??????? ????????? ???????? ??????????",
                                "languageCode": "ar",
                                "writingScriptCode": "ar"
                            }
                        }
                    ]
                },
                {
                    "nameType": "Also Known As",
                    "name": "EGEMAC",
                    "nameGroups": [
                        {
                            "nameType": "Original Script Name",
                            "nativeScriptName": {
                                "name": "???????",
                                "languageCode": "ar",
                                "writingScriptCode": "ar"
                            }
                        }
                    ]
                },
                {
                    "nameType": "Also Known As",
                    "name": "Gorman Electrical Products"
                },
                {
                    "nameType": "Also Known As",
                    "name": "Gorman Electrical Manufacturing Co.",
                    "nameGroups": [
                        {
                            "nameType": "Original Script Name",
                            "nativeScriptName": {
                                "name": "??????? ????????? ???????? ??????????",
                                "languageCode": "ar",
                                "writingScriptCode": "ar"
                            }
                        }
                    ]
                }
            ],
            "dateReferences": [
                {
                    "referenceType": "Date of Registration",
                    "year": 1974
                }
            ],
            "countryReferences": [
                {
                    "referenceType": "Country of Registration",
                    "name": "Egypt",
                    "isoAlpha2Code": "EG",
                    "isTerritory": false
                },
                {
                    "referenceType": "Country of Current Ownership",
                    "name": "Egypt",
                    "isoAlpha2Code": "EG",
                    "isTerritory": false
                },
                {
                    "referenceType": "Country of Past Ownership",
                    "name": "Egypt",
                    "isoAlpha2Code": "EG",
                    "isTerritory": false
                }
            ],
            "addressReferences": [
                {
                    "addressLine": "1 Kablat street , Mattaria, P.O. Box 2634",
                    "addressLocality": "Cairo",
                    "addressRegion": "Cairo",
                    "country": {
                        "name": "Egypt",
                        "isoAlpha2Code": "EG",
                        "isTerritory": "false"
                    },
                    "url": "http://www.egemac.com.eg"
                }
            ],
            "identificationReferences": [
                {
                    "referenceType": "North American Industry Classification System (NAICS)",
                    "referenceID": "335999"
                },
                {
                    "referenceType": "NACE (European Union Economic Activity Classification System)",
                    "referenceID": "31.6"
                },
                {
                    "referenceType": "Standard Industrial Classification (SIC)",
                    "referenceID": "3679"
                },
                {
                    "referenceType": "DUNS Number",
                    "referenceID": "643435662"
                }
            ],
            "stateOwnedCompaniesContent": {
                "status": "Active",
                "riskProfiles": [
                    {
                        "level1": "Entity (SO)",
                        "level2": "State Owned Company (SOC)"
                    }
                ],
                "djiiIndustries": [
                    {
                        "industryName": "Power, distribution and specialty transformers. Includes electric motors, generators, motor generator sets, switchgear and switchboard apparatus.",
                        "industryID": "i342",
                        "industryDescription": "Electrical Components/Equipment"
                    }
                ],
                "shareOwnerships": [
                    {
                        "level1": "Voting Control",
                        "level2": "Unknown"
                    },
                    {
                        "level1": "Board Appointing Control",
                        "level2": "Unknown"
                    },
                    {
                        "level1": "Ownership Percentage",
                        "level2": "Majority-Known",
                        "level3": "Past",
                        "ownershipPercentage": "75.830",
                        "notes": "This company is a 51.33 owned subsidiary of wholly state-owned Egyptian Electricity Holding Company (EEHC). Moreover, wholly state-owned National Company for Construction and Development (NCCD) holds 24.50%, and Misr Co. for Mechanical and Electrical Projects (Kahromica) holds 5%."
                    },
                    {
                        "level1": "Ownership Percentage",
                        "level2": "Majority-Unknown",
                        "level3": "Current",
                        "notes": "This company is a 62% owned subsidiary of wholly state-owned Egyptian Electricity Holding Company (EEHC), and Misr Co. for Mechanical and Electrical Projects (Kahromica) holds 5%."
                    }
                ]
            },
            "associations": [
                {
                    "entityID": "10547821",
                    "associationType": "Shareholder/Owner",
                    "riskProfile1": "Entity (SO)",
                    "riskProfile2": "State Owned Company (SOC)",
                    "isFormer": false
                },
                {
                    "entityID": "10548291",
                    "associationType": "Parent Company",
                    "riskProfile1": "Entity (SO)",
                    "riskProfile2": "State Owned Company (SOC)",
                    "isFormer": false
                },
                {
                    "entityID": "13103721",
                    "associationType": "Asset",
                    "riskProfile1": "Entity (SO)",
                    "riskProfile2": "State Owned Company (SOC)",
                    "isFormer": false
                }
            ],
            "reviewDate": "2018-02-19 12:15:48.767"
        }
    ]
}