Cookies Settings

Loading

dnb-logo
Direct 2.0
Collapse

Find Competitors

Returns all the competitors for a given company.

Update History

  • January 29, 2016 (v6.2 SOAP & REST): The UnitofSize attribute is added to SalesRevenueAmount for Find Competitor.

Feature Request

IMPORTANT: Please see the new Online Services Security Enhancement Release, effective November 09, 2020.

Overview

When requesting this feature, a valid D-U-N-S Number for a company will be required. An option exists to request only the top competitors.

A top competitor designation is assigned by D&B based on analysis of the company and industry in which it operates. Public companies frequently identify top competitors in their public filings, which is also taken into consideration.

Pagination: This feature does not offer any pagination options, and will return an unlimited number of results (typically fewer than one hundred).

Data Layer Entitlement

For customers in U.S. and Canadian markets, the API is provisioned for specific collections of products, reports, and/or features (collectively referred to as data layers) for production and trial usage. Entitlement is not required for testing in the sandbox environment.

  • This feature is entitled as "Search/Lookup for Companies" for D&B Direct 2.0 customers.

For customers in the UK, Ireland, Belgium, Netherlands and Luxembourg markets, the API is provisioned as a specific set of data layers for production, trial, and sandbox usage.

  • This particular data layer is included in the D&B Direct Onboard 2.0 suite.

Specification

Sample Request
GET https://direct.dnb.com/V6.1/organizations/804735132/competitors
Authorization: <My Token>
Note: This sample is for illustrative purposes only. Actual calls using the sample parameters may not produce the same results.
Name Characteristics
{DUNS} string up to 15 chars. Pattern: {([0-9a-zA-Z]*)}., Required

The D-U-N-S Number is D&B's identification number, which provides unique identification of this organization, in accordance with the Data Universal Numbering System (D-U-N-S).

ReturnOnlyTopCompetitorIndicator boolean, Optional

When true (set to 1), only the organizations classified as a top competitor for the subject organization have to be listed in the search response. When false (set to 0), all the organizations identified as a competitor for the subject organization have to be listed in the search response.

Endpoint

Use the following endpoint for requesting this feature. The {version} is dependent on the underlying service delivering the response.

NOTE: While "organizations" is part of this endpoint, there is no service by this name. Many D&B Direct calls have a similar structure; however, the {version} component is based on the SERVICE to which a given product is associated.

REST (EntityList)
GET https://direct.dnb.com/V{version}/organizations/{DUNS}/competitors

Testing

This operation will return a static set of results in the D&B Direct test environment (sandbox), regardless of the request parameters.

Feature Response

NOTE: The D&B Direct REST implementation uses the BadgerFish approach for JSON with some minor variations.

Specification

The following is a list of the possible data fields returned by this operation in the JSON response. Samples are provided for testing successful and failed retrieval, and to demonstrate the basic layout of a response. The data returned in samples may not represent actual values that this feature will deliver.

NOTE: The D-U-N-S Number returned in the response will be a nine-digit zero-padded, numeric value.

Sample Response
{"FindCompetitorResponse": {
  "@ServiceVersionNumber": "6.0",
  "TransactionDetail":   {
    "ServiceTransactionID": "Id-5a50daf5527278af89fbffff-1",
    "TransactionTimestamp": "2013-10-31T11:35:12"
  },
  "TransactionResult":   {
    "SeverityText": "Information",
    "ResultID": "CM000",
    "ResultText": "Success"
  },
  "FindCompetitorResponseDetail": {"Competitor":   [
        {
      "DUNSNumber": "382014330",
      "OrganizationPrimaryName": {"OrganizationName": {"$": "Cap Gemini S.A."}},
      "PrimaryAddress":       {
        "PrimaryTownName": "Paris",
        "CountryISOAlpha2Code": "FR",
        "CountryOfficialName": "France"
      },
      "GlobalUltimateDUNSNumber": "382014330",
      "ParentDUNSNumber": "382014330",
      "SalesRevenueAmount": [{"$": 13563.876}],
      "TopCompetitorIndicator": false
    },
        {
      "DUNSNumber": "275127975",
      "OrganizationPrimaryName": {"OrganizationName": {"$": "Alcatel-Lucent"}},
      "PrimaryAddress":       {
        "PrimaryTownName": "Paris",
        "CountryISOAlpha2Code": "FR",
        "TerritoryAbbreviatedName": "Paris",
        "CountryOfficialName": "France"
      },
      "GlobalUltimateDUNSNumber": "275127975",
      "ParentDUNSNumber": "275127975",
      "SalesRevenueAmount": [{"$": 19090.389}],
      "TopCompetitorIndicator": false
    },
        {
      "DUNSNumber": "316268655",
      "OrganizationPrimaryName": {"OrganizationName": {"$": "SAP AG"}},
      "PrimaryAddress":       {
        "PrimaryTownName": "Walldorf",
        "CountryISOAlpha2Code": "DE",
        "CountryOfficialName": "Germany"
      },
      "GlobalUltimateDUNSNumber": "316268655",
      "ParentDUNSNumber": "316268655",
      "SalesRevenueAmount": [{"$": 21438.6945}],
      "TopCompetitorIndicator": false
    },
        {
      "DUNSNumber": "915361146",
      "OrganizationPrimaryName": {"OrganizationName": {"$": "Wipro Technologies"}},
      "PrimaryAddress":       {
        "PrimaryTownName": "Bangalore",
        "CountryISOAlpha2Code": "IN",
        "TerritoryAbbreviatedName": "Karnataka",
        "CountryOfficialName": "India"
      },
      "GlobalUltimateDUNSNumber": "650174378",
      "ParentDUNSNumber": "650174378",
      "TopCompetitorIndicator": false
    },
        {
      "DUNSNumber": "916152424",
      "OrganizationPrimaryName": {"OrganizationName": {"$": "Tata Consultancy Services Limited"}},
      "PrimaryAddress":       {
        "PrimaryTownName": "Mumbai",
        "CountryISOAlpha2Code": "IN",
        "TerritoryAbbreviatedName": "Maharashtra",
        "CountryOfficialName": "India"
      },
      "GlobalUltimateDUNSNumber": "650048044",
      "ParentDUNSNumber": "650048044",
      "SalesRevenueAmount": [{"$": 11527.07484}],
      "TopCompetitorIndicator": false
    },
        {
      "DUNSNumber": "862172652",
      "OrganizationPrimaryName": {"OrganizationName": {"$": "HCL Technologies Limited"}},
      "PrimaryAddress":       {
        "PrimaryTownName": "Noida",
        "CountryISOAlpha2Code": "IN",
        "TerritoryAbbreviatedName": "Uttar Pradesh",
        "CountryOfficialName": "India"
      },
      "GlobalUltimateDUNSNumber": "862172652",
      "ParentDUNSNumber": "862172652",
      "SalesRevenueAmount": [{"$": 3705.754845}],
      "TopCompetitorIndicator": false
    },
        {
      "DUNSNumber": "650088735",
      "OrganizationPrimaryName": {"OrganizationName": {"$": "Infosys Technologies Limited"}},
      "PrimaryAddress":       {
        "PrimaryTownName": "Bengaluru",
        "CountryISOAlpha2Code": "IN",
        "TerritoryAbbreviatedName": "Karnataka",
        "CountryOfficialName": "India"
      },
      "GlobalUltimateDUNSNumber": "650088735",
      "ParentDUNSNumber": "650088735",
      "SalesRevenueAmount": [{"$": 7398}],
      "TopCompetitorIndicator": false
    },
        {
      "DUNSNumber": "985015354",
      "OrganizationPrimaryName": {"OrganizationName": {"$": "Accenture plc"}},
      "PrimaryAddress":       {
        "PrimaryTownName": "Dublin",
        "CountryISOAlpha2Code": "IE",
        "CountryOfficialName": "Ireland"
      },
      "GlobalUltimateDUNSNumber": "985015354",
      "ParentDUNSNumber": "985015354",
      "SalesRevenueAmount": [{"$": 30394.285}],
      "TopCompetitorIndicator": true
    },
        {
      "DUNSNumber": "690710561",
      "OrganizationPrimaryName": {"OrganizationName": {"$": "NTT DATA CORPORATION"}},
      "PrimaryAddress":       {
        "PrimaryTownName": "Koto-Ku",
        "CountryISOAlpha2Code": "JP",
        "TerritoryAbbreviatedName": "Tokyo",
        "CountryOfficialName": "Japan"
      },
      "GlobalUltimateDUNSNumber": "690626718",
      "ParentDUNSNumber": "690626718",
      "SalesRevenueAmount": [{"$": 13813.59401}],
      "TopCompetitorIndicator": false
    },
        {
      "DUNSNumber": "690549639",
      "OrganizationPrimaryName": {"OrganizationName": {"$": "Seiko Epson Corporation"}},
      "PrimaryAddress":       {
        "PrimaryTownName": "Suwa",
        "CountryISOAlpha2Code": "JP",
        "TerritoryAbbreviatedName": "Nagano",
        "CountryOfficialName": "Japan"
      },
      "GlobalUltimateDUNSNumber": "690549639",
      "ParentDUNSNumber": "690549639",
      "SalesRevenueAmount": [{"$": 9032.26117}],
      "TopCompetitorIndicator": false
    },
        {
      "DUNSNumber": "690549118",
      "OrganizationPrimaryName": {"OrganizationName": {"$": "Ricoh Company, Ltd."}},
      "PrimaryAddress":       {
        "PrimaryTownName": "Chuo-Ku",
        "CountryISOAlpha2Code": "JP",
        "TerritoryAbbreviatedName": "Tokyo",
        "CountryOfficialName": "Japan"
      },
      "GlobalUltimateDUNSNumber": "690549118",
      "ParentDUNSNumber": "690549118",
      "SalesRevenueAmount": [{"$": 20418.91317}],
      "TopCompetitorIndicator": false
    },
        {
      "DUNSNumber": "690543517",
      "OrganizationPrimaryName": {"OrganizationName": {"$": "Toshiba Corporation"}},
      "PrimaryAddress":       {
        "PrimaryTownName": "Minato-Ku",
        "CountryISOAlpha2Code": "JP",
        "TerritoryAbbreviatedName": "Tokyo",
        "CountryOfficialName": "Japan"
      },
      "GlobalUltimateDUNSNumber": "690543517",
      "ParentDUNSNumber": "690543517",
      "SalesRevenueAmount": [{"$": 62973.09799}],
      "TopCompetitorIndicator": false
    },
        {
      "DUNSNumber": "690553649",
      "OrganizationPrimaryName": {"OrganizationName": {"$": "Sony Corporation"}},
      "PrimaryAddress":       {
        "PrimaryTownName": "Tokyo",
        "CountryISOAlpha2Code": "JP",
        "CountryOfficialName": "Japan"
      },
      "GlobalUltimateDUNSNumber": "690553649",
      "ParentDUNSNumber": "690553649",
      "SalesRevenueAmount": [{"$": 72157.02911}],
      "TopCompetitorIndicator": false
    },
        {
      "DUNSNumber": "690541685",
      "OrganizationPrimaryName": {"OrganizationName": {"$": "NEC Corporation"}},
      "PrimaryAddress":       {
        "PrimaryTownName": "Minato-Ku",
        "CountryISOAlpha2Code": "JP",
        "TerritoryAbbreviatedName": "Tokyo",
        "CountryOfficialName": "Japan"
      },
      "GlobalUltimateDUNSNumber": "690541685",
      "ParentDUNSNumber": "690541685",
      "SalesRevenueAmount": [{"$": 32589.77149}],
      "TopCompetitorIndicator": false
    },
        {
      "DUNSNumber": "690536552",
      "OrganizationPrimaryName": {"OrganizationName": {"$": "Panasonic Corporation"}},
      "PrimaryAddress":       {
        "PrimaryTownName": "Kadoma",
        "CountryISOAlpha2Code": "JP",
        "TerritoryAbbreviatedName": "Osaka",
        "CountryOfficialName": "Japan"
      },
      "GlobalUltimateDUNSNumber": "690536552",
      "ParentDUNSNumber": "690536552",
      "SalesRevenueAmount": [{"$": 77485.30745}],
      "TopCompetitorIndicator": false
    },
        {
      "DUNSNumber": "690541503",
      "OrganizationPrimaryName": {"OrganizationName": {"$": "Hitachi, Ltd."}},
      "PrimaryAddress":       {
        "PrimaryTownName": "Tokyo",
        "CountryISOAlpha2Code": "JP",
        "CountryOfficialName": "Japan"
      },
      "GlobalUltimateDUNSNumber": "690541503",
      "ParentDUNSNumber": "690541503",
      "SalesRevenueAmount": [{"$": 95925.76331}],
      "TopCompetitorIndicator": false
    },
        {
      "DUNSNumber": "690535281",
      "OrganizationPrimaryName": {"OrganizationName": {"$": "Fujitsu Limited"}},
      "PrimaryAddress":       {
        "PrimaryTownName": "Minato-Ku",
        "CountryISOAlpha2Code": "JP",
        "TerritoryAbbreviatedName": "Tokyo",
        "CountryOfficialName": "Japan"
      },
      "GlobalUltimateDUNSNumber": "690535281",
      "ParentDUNSNumber": "690535281",
      "SalesRevenueAmount": [{"$": 46490.13408}],
      "TopCompetitorIndicator": false
    },
        {
      "DUNSNumber": "353957491",
      "OrganizationPrimaryName": {"OrganizationName": {"$": "Telefonaktiebolaget LM Ericsson"}},
      "PrimaryAddress":       {
        "PrimaryTownName": "Kista",
        "CountryISOAlpha2Code": "SE",
        "TerritoryAbbreviatedName": "Stockholm",
        "CountryOfficialName": "Sweden"
      },
      "GlobalUltimateDUNSNumber": "353957491",
      "ParentDUNSNumber": "353957491",
      "SalesRevenueAmount": [{"$": 34986.8544}],
      "TopCompetitorIndicator": false
    },
        {
      "DUNSNumber": "656122470",
      "OrganizationPrimaryName": {"OrganizationName": {"$": "Taiwan Semiconductor Manufacturing Company Limited"}},
      "PrimaryAddress":       {
        "PrimaryTownName": "Hsinchu City",
        "CountryISOAlpha2Code": "TW",
        "CountryOfficialName": "Taiwan"
      },
      "GlobalUltimateDUNSNumber": "656122470",
      "ParentDUNSNumber": "656122470",
      "SalesRevenueAmount": [{"$": 17384.576924}],
      "TopCompetitorIndicator": false
    },
        {
      "DUNSNumber": "002563455",
      "OrganizationPrimaryName": {"OrganizationName": {"$": "Deloitte Consulting LLP"}},
      "PrimaryAddress":       {
        "PrimaryTownName": "New York",
        "CountryISOAlpha2Code": "US",
        "TerritoryAbbreviatedName": "NY",
        "CountryOfficialName": "United States"
      },
      "GlobalUltimateDUNSNumber": "014127109",
      "ParentDUNSNumber": "014127109",
      "SalesRevenueAmount": [{"$": 494.2}],
      "TopCompetitorIndicator": false
    },
        {
      "DUNSNumber": "799901301",
      "OrganizationPrimaryName": {"OrganizationName": {"$": "Cognizant Technology Solutions Corporation"}},
      "PrimaryAddress":       {
        "PrimaryTownName": "Teaneck",
        "CountryISOAlpha2Code": "US",
        "TerritoryAbbreviatedName": "NJ",
        "CountryOfficialName": "United States"
      },
      "GlobalUltimateDUNSNumber": "799901301",
      "ParentDUNSNumber": "799901301",
      "SalesRevenueAmount": [{"$": 7346.472}],
      "TopCompetitorIndicator": false
    },
        {
      "DUNSNumber": "046667523",
      "OrganizationPrimaryName": {"OrganizationName": {"$": "HP Enterprise Services, LLC"}},
      "PrimaryAddress":       {
        "PrimaryTownName": "Plano",
        "CountryISOAlpha2Code": "US",
        "TerritoryAbbreviatedName": "TX",
        "CountryOfficialName": "United States"
      },
      "GlobalUltimateDUNSNumber": "009122532",
      "ParentDUNSNumber": "009122532",
      "SalesRevenueAmount": [{"$": 12659.9}],
      "TopCompetitorIndicator": false
    },
        {
      "DUNSNumber": "623331717",
      "OrganizationPrimaryName": {"OrganizationName": {"$": "Lexmark International, Inc."}},
      "PrimaryAddress":       {
        "PrimaryTownName": "Lexington",
        "CountryISOAlpha2Code": "US",
        "TerritoryAbbreviatedName": "KY",
        "CountryOfficialName": "United States"
      },
      "GlobalUltimateDUNSNumber": "623331717",
      "ParentDUNSNumber": "623331717",
      "SalesRevenueAmount": [{"$": 3797.6}],
      "TopCompetitorIndicator": false
    },
        {
      "DUNSNumber": "144709193",
      "OrganizationPrimaryName": {"OrganizationName": {"$": "Oracle Corporation"}},
      "PrimaryAddress":       {
        "PrimaryTownName": "Redwood City",
        "CountryISOAlpha2Code": "US",
        "TerritoryAbbreviatedName": "CA",
        "CountryOfficialName": "United States"
      },
      "GlobalUltimateDUNSNumber": "144709193",
      "ParentDUNSNumber": "144709193",
      "SalesRevenueAmount": [{"$": 37180}],
      "TopCompetitorIndicator": false
    },
        {
      "DUNSNumber": "037787298",
      "OrganizationPrimaryName": {"OrganizationName": {"$": "Novell, Inc."}},
      "PrimaryAddress":       {
        "PrimaryTownName": "Provo",
        "CountryISOAlpha2Code": "US",
        "TerritoryAbbreviatedName": "UT",
        "CountryOfficialName": "United States"
      },
      "GlobalUltimateDUNSNumber": "783359602",
      "ParentDUNSNumber": "103377503",
      "SalesRevenueAmount": [{"$": 313.6}],
      "TopCompetitorIndicator": false
    },
        {
      "DUNSNumber": "081466849",
      "OrganizationPrimaryName": {"OrganizationName": {"$": "Microsoft Corporation"}},
      "PrimaryAddress":       {
        "PrimaryTownName": "Redmond",
        "CountryISOAlpha2Code": "US",
        "TerritoryAbbreviatedName": "WA",
        "CountryOfficialName": "United States"
      },
      "GlobalUltimateDUNSNumber": "081466849",
      "ParentDUNSNumber": "081466849",
      "SalesRevenueAmount": [{"$": 77849}],
      "TopCompetitorIndicator": true
    },
        {
      "DUNSNumber": "047897855",
      "OrganizationPrimaryName": {"OrganizationName": {"$": "Intel Corporation"}},
      "PrimaryAddress":       {
        "PrimaryTownName": "Santa Clara",
        "CountryISOAlpha2Code": "US",
        "TerritoryAbbreviatedName": "CA",
        "CountryOfficialName": "United States"
      },
      "GlobalUltimateDUNSNumber": "047897855",
      "ParentDUNSNumber": "047897855",
      "SalesRevenueAmount": [{"$": 53341}],
      "TopCompetitorIndicator": false
    },
        {
      "DUNSNumber": "153804570",
      "OrganizationPrimaryName": {"OrganizationName": {"$": "Cisco Systems, Inc."}},
      "PrimaryAddress":       {
        "PrimaryTownName": "San Jose",
        "CountryISOAlpha2Code": "US",
        "TerritoryAbbreviatedName": "CA",
        "CountryOfficialName": "United States"
      },
      "GlobalUltimateDUNSNumber": "153804570",
      "ParentDUNSNumber": "153804570",
      "SalesRevenueAmount": [{"$": 48607}],
      "TopCompetitorIndicator": false
    },
        {
      "DUNSNumber": "114315195",
      "OrganizationPrimaryName": {"OrganizationName": {"$": "Dell Inc."}},
      "PrimaryAddress":       {
        "PrimaryTownName": "Round Rock",
        "CountryISOAlpha2Code": "US",
        "TerritoryAbbreviatedName": "TX",
        "CountryOfficialName": "United States"
      },
      "GlobalUltimateDUNSNumber": "114315195",
      "ParentDUNSNumber": "114315195",
      "SalesRevenueAmount": [{"$": 56940}],
      "TopCompetitorIndicator": false
    },
        {
      "DUNSNumber": "011589751",
      "OrganizationPrimaryName": {"OrganizationName": {"$": "BMC Software, Inc."}},
      "PrimaryAddress":       {
        "PrimaryTownName": "Houston",
        "CountryISOAlpha2Code": "US",
        "TerritoryAbbreviatedName": "TX",
        "CountryOfficialName": "United States"
      },
      "GlobalUltimateDUNSNumber": "079161545",
      "ParentDUNSNumber": "079161545",
      "SalesRevenueAmount": [{"$": 2201.4}],
      "TopCompetitorIndicator": false
    },
        {
      "DUNSNumber": "005358932",
      "OrganizationPrimaryName": {"OrganizationName": {"$": "Unisys Corporation"}},
      "PrimaryAddress":       {
        "PrimaryTownName": "Blue Bell",
        "CountryISOAlpha2Code": "US",
        "TerritoryAbbreviatedName": "PA",
        "CountryOfficialName": "United States"
      },
      "GlobalUltimateDUNSNumber": "005358932",
      "ParentDUNSNumber": "005358932",
      "SalesRevenueAmount": [{"$": 3706.4}],
      "TopCompetitorIndicator": false
    },
        {
      "DUNSNumber": "007321904",
      "OrganizationPrimaryName": {"OrganizationName": {"$": "Texas Instruments Incorporated"}},
      "PrimaryAddress":       {
        "PrimaryTownName": "Dallas",
        "CountryISOAlpha2Code": "US",
        "TerritoryAbbreviatedName": "TX",
        "CountryOfficialName": "United States"
      },
      "GlobalUltimateDUNSNumber": "007321904",
      "ParentDUNSNumber": "007321904",
      "SalesRevenueAmount": [{"$": 12825}],
      "TopCompetitorIndicator": false
    },
        {
      "DUNSNumber": "001325463",
      "OrganizationPrimaryName": {"OrganizationName": {"$": "Motorola Solutions, Inc."}},
      "PrimaryAddress":       {
        "PrimaryTownName": "Schaumburg",
        "CountryISOAlpha2Code": "US",
        "TerritoryAbbreviatedName": "IL",
        "CountryOfficialName": "United States"
      },
      "GlobalUltimateDUNSNumber": "001325463",
      "ParentDUNSNumber": "001325463",
      "SalesRevenueAmount": [{"$": 8698}],
      "TopCompetitorIndicator": false
    },
        {
      "DUNSNumber": "009122532",
      "OrganizationPrimaryName": {"OrganizationName": {"$": "Hewlett-Packard Company"}},
      "PrimaryAddress":       {
        "PrimaryTownName": "Palo Alto",
        "CountryISOAlpha2Code": "US",
        "TerritoryAbbreviatedName": "CA",
        "CountryOfficialName": "United States"
      },
      "GlobalUltimateDUNSNumber": "009122532",
      "ParentDUNSNumber": "009122532",
      "SalesRevenueAmount": [{"$": 120357}],
      "TopCompetitorIndicator": true
    },
        {
      "DUNSNumber": "001367960",
      "OrganizationPrimaryName": {"OrganizationName": {"$": "General Electric Company"}},
      "PrimaryAddress":       {
        "PrimaryTownName": "Fairfield",
        "CountryISOAlpha2Code": "US",
        "TerritoryAbbreviatedName": "CT",
        "CountryOfficialName": "United States"
      },
      "GlobalUltimateDUNSNumber": "001367960",
      "ParentDUNSNumber": "001367960",
      "SalesRevenueAmount": [{"$": 147359}],
      "TopCompetitorIndicator": false
    },
        {
      "DUNSNumber": "097447148",
      "OrganizationPrimaryName": {"OrganizationName": {"$": "EMC Corporation"}},
      "PrimaryAddress":       {
        "PrimaryTownName": "Hopkinton",
        "CountryISOAlpha2Code": "US",
        "TerritoryAbbreviatedName": "MA",
        "CountryOfficialName": "United States"
      },
      "GlobalUltimateDUNSNumber": "097447148",
      "ParentDUNSNumber": "097447148",
      "SalesRevenueAmount": [{"$": 21713.902}],
      "TopCompetitorIndicator": false
    },
        {
      "DUNSNumber": "009581091",
      "OrganizationPrimaryName": {"OrganizationName": {"$": "Computer Sciences Corporation"}},
      "PrimaryAddress":       {
        "PrimaryTownName": "Falls Church",
        "CountryISOAlpha2Code": "US",
        "TerritoryAbbreviatedName": "VA",
        "CountryOfficialName": "United States"
      },
      "GlobalUltimateDUNSNumber": "009581091",
      "ParentDUNSNumber": "009581091",
      "SalesRevenueAmount": [{"$": 14993}],
      "TopCompetitorIndicator": false
    },
        {
      "DUNSNumber": "080399256",
      "OrganizationPrimaryName": {"OrganizationName": {"$": "CA, Inc."}},
      "PrimaryAddress":       {
        "PrimaryTownName": "Islandia",
        "CountryISOAlpha2Code": "US",
        "TerritoryAbbreviatedName": "NY",
        "CountryOfficialName": "United States"
      },
      "GlobalUltimateDUNSNumber": "080399256",
      "ParentDUNSNumber": "080399256",
      "SalesRevenueAmount": [{"$": 4643}],
      "TopCompetitorIndicator": false
    },
        {
      "DUNSNumber": "216725944",
      "OrganizationPrimaryName": {"OrganizationName": {"$": "Deloitte Global Services Limited"}},
      "PrimaryAddress":       {
        "PrimaryTownName": "London",
        "CountryISOAlpha2Code": "GB",
        "TerritoryAbbreviatedName": "London",
        "CountryOfficialName": "United Kingdom"
      },
      "GlobalUltimateDUNSNumber": "216725944",
      "ParentDUNSNumber": "216725944",
      "SalesRevenueAmount": [{"$": 847.368}],
      "TopCompetitorIndicator": false
    }
  ]}
}}
Name Characteristics
FindCompetitorResponse Aggregate
FindCompetitorResponse { FindCompetitorResponseDetail Aggregate, Optional

Records data relating to the competing organizations for the subject organization. This may include details such as the name and address of the competing organization.

FindCompetitorResponse { FindCompetitorResponseDetail { Competitor Aggregate, Optional (Infinite)

Records information on the competing organization for the subject.

FindCompetitorResponse { FindCompetitorResponseDetail { Competitor { DUNSNumber string up to 15 chars. Pattern: {([0-9a-zA-Z]*)}., Required

The numeric value assigned by Dun & Bradstreet to uniquely identify the organization. The subject identifier under the Data Universal Numbering System. This is a numeric which is always 9 digits; the leading digit or digits may be zero.

FindCompetitorResponse { FindCompetitorResponseDetail { Competitor { OrganizationPrimaryName Aggregate, Required

The current name in different languages and / or writing scripts by which the organization is primarily known / identified.

FindCompetitorResponse { FindCompetitorResponseDetail { Competitor { OrganizationPrimaryName { OrganizationName string up to 256 chars., Required
END: FindCompetitorResponse } FindCompetitorResponseDetail } Competitor } OrganizationPrimaryName /Aggregate
FindCompetitorResponse { FindCompetitorResponseDetail { Competitor { PrimaryAddress Aggregate, Optional

Records the primary or physical address of a subject. For an organization this is the principal address at which the organization is located. For an individual, this is the home address.

FindCompetitorResponse { FindCompetitorResponseDetail { Competitor { PrimaryAddress { PrimaryTownName string up to 64 chars., Optional
FindCompetitorResponse { FindCompetitorResponseDetail { Competitor { PrimaryAddress { CountryISOAlpha2Code string at least 2 chars. up to 2 chars., Optional
FindCompetitorResponse { FindCompetitorResponseDetail { Competitor { PrimaryAddress { TerritoryAbbreviatedName string up to 64 chars., Optional
FindCompetitorResponse { FindCompetitorResponseDetail { Competitor { PrimaryAddress { CountryOfficialName string up to 64 chars., Optional

The legal name of the country for this address.

END: FindCompetitorResponse } FindCompetitorResponseDetail } Competitor } PrimaryAddress /Aggregate
FindCompetitorResponse { FindCompetitorResponseDetail { Competitor { GlobalUltimateDUNSNumber string up to 15 chars. Pattern: {([0-9a-zA-Z]*)}., Optional

The numeric value assigned by Dun & Bradstreet to uniquely identify the global ultimate organization .This subject identifier under the Data Universal Numbering System. This is a numeric which is always 9 digits; the leading digit or digits may be zero.

FindCompetitorResponse { FindCompetitorResponseDetail { Competitor { ParentDUNSNumber string up to 15 chars. Pattern: {([0-9a-zA-Z]*)}., Optional

The numeric value assigned by Dun & Bradstreet to uniquely identify the parent organization .This subject identifier under the Data Universal Numbering System. This is a numeric which is always 9 digits; the leading digit or digits may be zero.

FindCompetitorResponse { FindCompetitorResponseDetail { Competitor { SalesRevenueAmount decimal, Optional (Infinite)

The monetary value of income received from customers from the sale of the business' goods and/or services. This means it is the gross sales minus any returns, rebates/discounts, allowances for damages or shortages, shipping expenses passed on to the customer, and amounts due where there is not a reasonable expectation of collection.

FindCompetitorResponse { FindCompetitorResponseDetail { Competitor { SalesRevenueAmount {@UnitOfSize attribute, Optional
FindCompetitorResponse { FindCompetitorResponseDetail { Competitor { TopCompetitorIndicator boolean, Optional

When true (set to 1), it indicates that this organization is a top competitor for the subject organization. When false (set to 0), it indicates that this organization is not a top competitor for the subject organization.

END: FindCompetitorResponse } FindCompetitorResponseDetail } Competitor /Aggregate
END: FindCompetitorResponse } FindCompetitorResponseDetail /Aggregate
END: FindCompetitorResponse /Aggregate

Response Codes & Error Handling

Successful service requests will return a CM000 response code in the TransactionResult ResultID field. Otherwise, one of the D&B Direct standard response codes will be returned.

This operation may return the following response codes: CM002, CM004, CM005, CM012, CM017, and SC001-SC009.

D&B Direct 2.0 API requests are provided on a metered basis; and may require entitlement prior to use in the production environment. In addition, a concurrency limit (QPS) is monitored to ensure that it is not exceeded. An error code will be returned in the event that a transaction is throttled.

Qualified usage (e.g., a successful response) is tracked and billed according to the terms & conditions of the customer's contract. The response codes CM000, CM010, PD002 and PD015 are considered successful. A built-in feature exists to prevent duplicate billing when multiple successful requests with the same criteria are submitted on the same calendar day (which is based on Eastern Standard Time [GMT-5]).

Business Elements

While D&B Direct uses a product canonical naming model in the request/response, many customers may be more familiar with the following business element labels.

Name Description
Competitor Organization Business Name Primary Company Name of the competitor

PCM XPath: //Competitor/ OrganizationPrimaryName/ OrganizationName

Competitor Organization Country Code Country Code of the competitor

PCM XPath: //Competitor/ PrimaryAddress/ CountryISOAlpha2Code

Competitor Organization Country Name Country Name of the competitor

PCM XPath: //Competitor/ PrimaryAddress/ CountryOfficialName

Competitor Organization D-U-N-S number DUNS Number of the competitor

PCM XPath: //Competitor/ DUNSNumber

Competitor Organization Global Ultimate DUNS Number global ultimate Organization DUNS Number of the Competitor

PCM XPath: //Competitor/ GlobalUltimateDUNSNumber

Competitor Organization Parent D-U-N-S Number parent Organization DUNS Number of the Competitor

PCM XPath: //Competitor/ ParentDUNSNumber

Competitor Organization Sales Revenue The sales number in millions (USD) for this competitor

PCM XPath: //Competitor/ SalesRevenueAmount

Competitor Organization Territory Abbreviated Name Territory Name of the Competitor

PCM XPath: //Competitor/ PrimaryAddress/ TerritoryAbbreviatedName

Competitor Organization Town Name City name of the competitor

PCM XPath: //Competitor/ PrimaryAddress/ PrimaryTownName

Top Competitor Organization Indicator Indicates if the competitor is a top competitor or not

PCM XPath: //Competitor/ TopCompetitorIndicator

The preceding list is not presented in the order, nor manner, in which the information is packaged and delivered via the D&B Direct API. 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.

Feature Notes

For each competitor, this feature will return the D-U-N-S Number, organization name, city, state, country, sales revenue, parent and global ultimate D-U-N-S Numbers, and the top competitor indicator.