Cookies Settings

Loading

dnb-logo
Direct 2.0
Collapse

People

Also known as Contact Profiles

This D&B Direct product provides information about the principal of an organization including name, job title, current salary information, along with, direct email and telephone information when available. The Enhanced level of the product provides additional details such as job and compensation history.

Update History

  • October 11, 2024 (ALL SOAP & REST): Updated Primary Address (Territory and Country) mapping for Russia market.
  • April 01, 2022 (ALL SOAP & REST): Registered company name data population fix for Italy, San Marino market
  • January 07, 2022 (ALL SOAP & REST): Defect fix to return proper response as per schema for FacsimileNumber element.
  • October 08, 2021 (ALL SOAP & REST): Defect fix to suppress principal information of non-English Principal name to avoid incomplete Principal and Management section in the response.
  • March 28, 2014 (v4.0 SOAP & REST): The business elements Management Responsibility (Principal) and Most Senior Principal Management Responsibility are now based on D&B's Management Responsibilty Code system, rather than the previously delivered Hoover's Job Code list. A table comparing the two sets of codes is available in the Data Primer.

What to do First

Principal IDs for company officers and directors may be obtained by using the following features:

Product Request

IMPORTANT: Due to a known issue, please do not include request values for SubmittingOfficeID.

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

Overview

When requesting this D&B Direct data layer, a valid D-U-N-S Number for a company, principal identification number (Principal ID), and the appropriate product code will be required.

This product also offers an option to specify the currency code applied to the results delivered. Possible values include: USD (default), CAD, GBP, EUR, JPY, and SEK.

Global Availability

The CNTCT, CNTCT_PLUS data layers are available for businesses domiciled in the following countries:

CNTCTCNTCT_PLUSCountryISO Code
YYUnited States of AmericaUS
YYBelgiumBE
YYFranceFR
YYGermanyDE
YYItalyIT
YYNetherlandsNL
YYPortugalPT
YYSpainES
YYUnited KingdomGB
YYAustraliaAU
YYNew ZealandNZ
YYAndorraAD
YYAnguillaAI
YYAntigua & BarbudaAG
YYArubaAW
YYBahamasBS
YYBarbadosBB
YYBelizeBZ
YYBermudaBM
YYBoliviaBO
YYBritish Virgin IslandsVG
YYCanadaCA
YYCayman IslandsKY
YYChileCL
YYColombiaCO
YYCosta RicaCR
YYDenmarkDK
YYDominicaDM
YYDominican RepublicDO
YYEcuadorEC
YYEl SalvadorSV
YYFaero IslandsFO
YYFinlandFI
YYGreenlandGL
YYGrenadaGD
YYGuatemalaGT
YYGuyanaGY
YYHaitiHT
YYHondurasHN
YYIrelandIE
YYJamaicaJM
YYJapanJP
YYLuxembourgLU
YYMexicoMX
YYMonacoMC
YYMontserratMS
YYNetherlands AntillesAN
YYBonaire, Sint Eustatius And SabaBQ
YYCuraçaoCW
YYSint Maarten (dutch)SX
YYNicaraguaNI
YYNorwayNO
YYPanamaPA
YYSaint Kitts & NevisKN
YYSaint LuciaLC
YYSaint VincentVC
YYSan MarinoSM
YYSurinameSR
YYSwedenSE
YYTaiwanTW
YYTrinidad And TobagoTT
YYTurks And CaicosTC
YYVenezuelaVE
YYAfghanistanAF
YYAlbaniaAL
YYAlgeriaDZ
YYAmerican SamoaAS
YYAngolaAO
YYArgentinaAR
YYArmeniaAM
YYAustriaAT
YYAzerbaijanAZ
YYBahrainBH
YYBangladeshBD
YYBenin, Peoples Republic ofBJ
YYBhutanBT
YYBosnia And HerzegovinaBA
YYBotswanaBW
YYBrazilBR
YYBruneiBN
YYBulgariaBG
YYBurkina FasoBF
YYBurma (myanmar)MM
YYBurundiBI
YYBelarusBY
YYKampuchea (prev. Cambodia)KH
YYCameroonCM
YYCape Verde, Republic ofCV
YYCentral Africa RepublicCF
YYChad, Republic ofTD
YYChina, Peoples Republic ofCN
YYChristmas IslandCX
YYComoros RepublicKM
YYCongo Democratic RepublicCD
YYCook IslandsCK
YYCroatiaHR
YYCyprusCY
YYTurkish Republic of Northern CyprusXT
YYCzech RepublicCZ
YYDjiboutiDJ
YYEgyptEG
YYEquatorial GuineaGQ
YYEritreaER
YYEstoniaEE
YYEthiopiaET
YYFalkland IslandsFK
YYFijiFJ
YYFrench GuianaGF
YYFrench Polynesia/tahitiPF
YYGabon RepublicGA
YYGambiaGM
YYGeorgiaGE
YYGhanaGH
YYGibraltarGI
YYGreeceGR
YYGuadeloupeGP
YYGuamGU
YYGuinea BissauGW
YYGuinea, Republic ofGN
YYHong Kong SARHK
YYHungaryHU
YYIcelandIS
YYIndiaIN
YYIndonesiaID
YYIranIR
YYIraqIQ
YYIsraelIL
YYIvory Coast/cote D'ivoireCI
YYJordanJO
YYKazakhstanKZ
YYKenyaKE
YYKiribatiKI
YYKorea, Republic ofKR
YYKuwaitKW
YYKyrgyzstanKG
YYLaosLA
YYLatviaLV
YYLebanonLB
YYLesothoLS
YYLiberiaLR
YYLibyaLY
YYLiechtensteinLI
YYLithuaniaLT
YYMacao SARMO
YYNorth MacedoniaMK
YYMadagasgarMG
YYMalawiMW
YYMalaysiaMY
YYMaldivesMV
YYMaliML
YYMaltaMT
YYMarianas IslandsMP
YYMarshall IslandsMH
YYMartiniqueMQ
YYMauritaniaMR
YYMauritiusMU
YYMoldovaMD
YYMontenegroME
YYMoroccoMA
YYMozambiqueMZ
YYNamibiaNA
YYNauruNR
YYNepalNP
YYNew CaledoniaNC
YYNigerNE
YYNigeriaNG
YYNorfolk IslandNF
YYOmanOM
YYPakistanPK
YYPapua New GuineaPG
YYParaguayPY
YYPeruPE
YYPhilippinesPH
YYPolandPL
YYQatarQA
YYReunion IslandRE
YYRomaniaRO
YYRussian FederationRU
YYRwandaRW
YYSaint HelenaSH
YYSaint Pierre et MiquelonPM
YYSao Tome & PrincipeST
YYSaudi ArabiaSA
YYSenegalSN
YYSerbiaRS
YYSeychellesSC
YYSierra LeoneSL
YYSingaporeSG
YYSlovakiaSK
YYSloveniaSI
YYSolomon IslandsSB
YYSomaliaSO
YYSouth AfricaZA
YYSri LankaLK
YYSudanSD
YYSouth SudanSS
YYEswatiniSZ
YYSwitzerlandCH
YYSyriaSY
YYTajhikstanTJ
YYTanzaniaTZ
YYThailandTH
YYTogoTG
YYTokelau IslandsTK
YYTongaTO
YYTunisiaTN
YYTurkiyeTR
YYTurkmenistanTM
YYTuvaluTV
YYUgandaUG
YYUkraineUA
YYUnited Arab EmiratesAE
YYUruguayUY
YYUzbekistanUZ
YYVanuatuVU
YYVietnamVN
YYWestern SamoaWS
YYYemenYE
YYZambiaZM
YYZimbabweZW
YYCongoCG
YYHoly See (Vatican City State)VA
YYKosovoXK
YYMicronesia, Federated States of FM
YYTimor-LesteTL
YYSouth Georgia and the South Sandwich Islands GS

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 product is entitled as "People" 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 NOT included in the D&B Direct Onboard suite.

Data Privacy

This product returns information that, in some jurisdictions, is considered personally identifiable information (PII). D&B customers that are entitled to request this product (and any third-parties that may be assisting with their implementation) are bound to the data privacy terms specified in the D&B Direct agreement.

Specification

Sample Request (CNTCT)
GET https://direct.dnb.com/V4.0/organizations/804735132/products/CNTCT?CountryISOAlpha2Code=US&PrincipalIdentificationNumber=5412658&PrincipalIdentificationNumberTypeCode=24215
Authorization: <My Token>
Sample Request (CNTCT_PLUS)
GET https://direct.dnb.com/V4.0/organizations/804735132/products/CNTCT_PLUS?CountryISOAlpha2Code=US&PrincipalIdentificationNumber=5412658&PrincipalIdentificationNumberTypeCode=24215
Authorization: <My Token>
Name Characteristics
{version} Attribute
ApplicationTransactionID string, up to 64 chars, Optional

A number assigned by the calling application to uniquely identify this request.

TransactionTimestamp DateTimestamp, Optional

The date and time when this request was created. When the request is from an intermediary, such as a workflow manager or service bus, this is the date and time when the message was sent to the D&B function, i.e., the date and time when the xml document was created by the requesting intermediary.

SubmittingOfficeID string, up to 64 chars, Optional

A number that identifies the system or the software application from where this request originated. / A number used to uniquely identfy the D&B business segment or delivery channel from where this request originated.

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

PrincipalIdentificationNumber string, Required

A number assigned by an external body or by D&B which either uniquely identifies or helps to identify an individual.

{productID} string, Required

An alphanumeric string that uniquely identifies the product being requested.

LanguagePreferenceCode integer, up to 7 digits, Optional

A D&B code value that defines the language in which the customer wants this product to be rendered.

CurrencyPreferenceISOAlpha3Code string, up to 3 chars, Optional

The customer preferred currency code, expressed in the ISO 4217 scheme published by International Organization for Standardization (ISO), in which the monetary values in the product should be expressed; e.g., USD, CAD, GBP, EUR.

Possible values: USD; CAD; GBP; EUR; JPY; SEK

ArchiveProductOptOutIndicator boolean, Optional

When 'true' indicates that the product being ordered is not to be stored. When 'false' indicates that the product being ordered is to be stored; however as this is the assumed condition there is no requirement to create this tag to represent this fact.

Possible values: true; false

ExtendArchivePeriodIndicator boolean, Optional

When 'true' the duration to archive the data is to be extended. Note: There is an additional cost for extending the archival period of the data purchased. When 'false' the duration to archive the data is not to be extended.

Possible values: true; false

PortfolioAssetContainerID long, Optional

A number used to uniquely identify the location where this product is to be stored.

CustomerReferenceText-n string, up to 240 chars, Optional (up to 5x)

A freeform reference string provided by the customer to be linked to the product in order to support subsequent order reconciliation.

CustomerBillingEndorsementText string, at least 1 chars, up to 240 chars, Optional

Text that is filled in by customer and commonly contains requesting individual or department name, or customer's own account/reference number and/or name for the case on which the product was provided.This text is a reference used during the billing process.

Endpoint

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

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 (Contact)
GET https://direct.dnb.com/V{version}/organizations/{DUNS}/products/{productID}?PrincipalIdentificationNumber={principalID}

Testing

Sandbox

The following parameters may be used for D&B Direct 2.0 developer sandbox requests to retrieve successful responses. The data returned from sandbox requests may not represent actual values that this feature will deliver.

CNTCTCNTCT_PLUSD-U-N-S Number (Country Code, Principal Identification Number)
Y 220646736 (GB, 2206467361)
 Y884114609 (GB, 1073021000000000)

Trials

When conducting testing in the production environment during a trial period, product requests will be limited to the local market of the customer.

Production

A set of D-U-N-S Numbers is available to D&B Direct 2.0 customers for performing non-billable transactions in the production environment.

Product Response

While data for a particular company may not contain values for each of the business elements, there may be items that are considered by D&B to be "essential" to yield the maximum benefit of a data layer. If any of these essential elements do not contain a value for a particular company, a PD005 response code will be returned, and your organization will not incur a usage credit for the request.

For all codified data delivered by D&B Direct, the response package will include the decoded text value as a data element with the code value attached as an attribute. Refer to the Reference Data Service for access to the D&B standard code tables.

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: Quality Indicators for contact data not available as part of this API.

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

Sample Response (CNTCT)
{"OrderProductResponse": {
  "@ServiceVersionNumber": "4.0",
  "TransactionDetail":   {
    "ServiceTransactionID": "Id-9f645703533c23ac12fb3233-2",
    "TransactionTimestamp": "2014-04-02T10:50:21.154-04:00"
  },
  "TransactionResult":   {
    "SeverityText": "Information",
    "ResultID": "CM000",
    "ResultText": "Success"
  },
  "OrderProductResponseDetail":   {
    "InquiryDetail":     {
      "DUNSNumber": "804735132",
      "CountryISOAlpha2Code": "US",
      "PrincipalIdentificationNumberDetail":       {
        "@DNBCodeValue": 24215,
        "PrincipalIdentificationNumber": "5412658"
      }
    },
    "Product":     {
      "DNBProductID": "CNTCT",
      "Organization":       {
        "SubjectHeader":         {
          "DUNSNumber": "804735132",
          "NonMarketableReasonText":           [                        
                        {
              "@DNBCodeValue": 25837,
              "$": "Insufficient Data"
            }
          ]
        },
        "Telecommunication": {"TelephoneNumber": [        {
          "TelecommunicationNumber": "(650) 555-0000",
          "InternationalDialingCode": "1"
        }]},
        "Location":         {
          "PrimaryAddress": [          {
            "StreetAddressLine": [{"LineText": "492 KOLLER ST"}],
            "PrimaryTownName": "San Francisco",
            "CountryISOAlpha2Code": "US",
            "TerritoryAbbreviatedName": "CA",
            "PostalCode": "94110",
            "TerritoryOfficialName": "California"
          }],
          "MailingAddress": [{"CountryISOAlpha2Code": "US"}]
        },
        "OrganizationName": {"OrganizationPrimaryName": [{"OrganizationName": {"$": "Gorman Manufacturing Company, Inc."}}]},
        "OrganizationDetail": {"FamilyTreeMemberRole":         [
          {"FamilyTreeMemberRoleText":           {
            "@DNBCodeValue": 12775,
            "$": "Global Ultimate"
          }},
          {"FamilyTreeMemberRoleText":           {
            "@DNBCodeValue": 12771,
            "$": "Headquarters"
          }},
          {"FamilyTreeMemberRoleText":           {
            "@DNBCodeValue": 12773,
            "$": "Parent"
          }},
          {"FamilyTreeMemberRoleText":           {
            "@DNBCodeValue": 12774,
            "$": "Domestic Ultimate"
          }}
        ]},
        "PrincipalsAndManagement": {"CurrentPrincipal": [        {
          "PrincipalName":           {
            "@type": "con:IndividualNameType",
            "NamePrefix": {"NamePrefixText": "Mr"},
            "FirstName": "Kevin",
            "MiddleName": "J",
            "LastName": "Hunt",
            "FullName": "Kevin J Hunt"
          },
          "JobTitle": [{"JobTitleText": {"$": "Sec-treas"}}],
          "CurrentManagementResponsibility": [{"ManagementResponsibilityText":           {
            "@ManagementResponsibilityCode": "A1B2",
            "$": "Secretary"
          }}],
          "PrincipalIdentificationNumberDetail":           {
            "@DNBCodeValue": 24215,
            "@TypeText": "Professional Contact Identifier",
            "PrincipalIdentificationNumber": "5412658"
          }
        }]}
      }
    }
  }
}}
Sample Response (CNTCT_PLUS)
{"OrderProductResponse": {
  "@ServiceVersionNumber": "4.0",
  "TransactionDetail":   {
    "ServiceTransactionID": "Id-bf048ae8533c2454053b5f09-2",
    "TransactionTimestamp": "2014-04-02T10:53:09.321-04:00"
  },
  "TransactionResult":   {
    "SeverityText": "Information",
    "ResultID": "CM000",
    "ResultText": "Success"
  },
  "OrderProductResponseDetail":   {
    "InquiryDetail":     {
      "DUNSNumber": "804735132",
      "CountryISOAlpha2Code": "US",
      "PrincipalIdentificationNumberDetail":       {
        "@DNBCodeValue": 24215,
        "PrincipalIdentificationNumber": "5412658"
      }
    },
    "Product":     {
      "DNBProductID": "CNTCT_PLUS",
      "Organization":       {
        "SubjectHeader":         {
          "DUNSNumber": "804735132",
          "NonMarketableReasonText":           [                        
                        {
              "@DNBCodeValue": 25837,
              "$": "Insufficient Data"
            }
          ]
        },
        "Telecommunication": {"TelephoneNumber": [        {
          "TelecommunicationNumber": "(650) 555-0000",
          "InternationalDialingCode": "1"
        }]},
        "Location":         {
          "PrimaryAddress": [          {
            "StreetAddressLine": [{"LineText": "492 KOLLER ST"}],
            "PrimaryTownName": "San Francisco",
            "CountryISOAlpha2Code": "US",
            "TerritoryAbbreviatedName": "CA",
            "PostalCode": "94110",
            "TerritoryOfficialName": "California"
          }],
          "MailingAddress": [{"CountryISOAlpha2Code": "US"}]
        },
        "OrganizationName": {"OrganizationPrimaryName": [{"OrganizationName": {"$": "Gorman Manufacturing Company, Inc."}}]},
        "OrganizationDetail": {"FamilyTreeMemberRole":         [
          {"FamilyTreeMemberRoleText":           {
            "@DNBCodeValue": 12773,
            "$": "Parent"
          }},
          {"FamilyTreeMemberRoleText":           {
            "@DNBCodeValue": 12771,
            "$": "Headquarters"
          }},
          {"FamilyTreeMemberRoleText":           {
            "@DNBCodeValue": 12774,
            "$": "Domestic Ultimate"
          }},
          {"FamilyTreeMemberRoleText":           {
            "@DNBCodeValue": 12775,
            "$": "Global Ultimate"
          }}
        ]},
        "PrincipalsAndManagement": {"CurrentPrincipal": [        {
          "PrincipalName":           {
            "@type": "con:IndividualNameType",
            "NamePrefix": {"NamePrefixText": "Mr"},
            "FirstName": "Kevin",
            "MiddleName": "J",
            "LastName": "Hunt",
            "FullName": "Kevin J Hunt"
          },
          "JobTitle": [{"JobTitleText": {"$": "Sec-treas"}}],
          "CurrentManagementResponsibility": [{"ManagementResponsibilityText":           {
            "@ManagementResponsibilityCode": "A1B2",
            "$": "Secretary"
          }}],
          "PrincipalIdentificationNumberDetail":           {
            "@DNBCodeValue": 24215,
            "@TypeText": "Professional Contact Identifier",
            "PrincipalIdentificationNumber": "5412658"
          }
        }]}
      }
    }
  }
}}
CNTCT CNTCT_PLUS Name Characteristics
Y Y OrderProductResponse Aggregate
Y Y OrderProductResponse @ServiceVersionNumber Attribute
Y Y OrderProductResponse { TransactionDetail Aggregate, Required

Records information necessary to process a particular request. Examples of a request is the ordering of a product.

Y Y OrderProductResponse { TransactionDetail { ApplicationTransactionID Element, string, up to 64 chars., Optional

A number assigned by the calling application to uniquely identify this request.

Y Y OrderProductResponse { TransactionDetail { ServiceTransactionID Element, string, up to 64 chars., Required

A number assigned by the D&B service to uniquely identify this transaction.

Y Y OrderProductResponse { TransactionDetail { TransactionTimestamp Element, Required

The date and time when this request was submitted or the date and time when the requesting intermediary, such as a workflow manager or service bus, sent the message to the D&B function, i.e., the date and time when the xml document was created by the requesting intermediary.

Y Y END: OrderProductResponse { TransactionDetail Aggregate
Y Y OrderProductResponse { TransactionResult Aggregate, Required

An aggregate that can repeat multiple times to record the different outcomes of the transaction.

Y Y OrderProductResponse { TransactionResult { SeverityText Element, string, up to 16 chars., Required

Text that records the criticality of the outcome, e.g., Information, Warning, Error, Fatal.

Y Y OrderProductResponse { TransactionResult { ResultID Element, string, up to 32 chars., Required

An alphanumeric string that uniquely identifies the outcome of the transaction.

Y Y OrderProductResponse { TransactionResult { ResultText Element, string, up to 512 chars., Optional

Text that explains the outcome of the transaction.

Y Y OrderProductResponse { TransactionResult { ResultMessage Aggregate, Optional (Array)

An aggregate that can repeat multiple times to record textual data that expands on the ResultID and ResultText to provide additional information to the user regarding the status of the transaction. If the status implies that there is a problem this may also provide guidance to the user on how to address it.

Y Y OrderProductResponse { TransactionResult { ResultMessage { ResultDescription Element, string, up to 512 chars., Required

Text that describes the additional information regarding the outcome of the transaction.

Y Y END: OrderProductResponse { TransactionResult { ResultMessage Aggregate
Y Y END: OrderProductResponse { TransactionResult Aggregate
Y Y OrderProductResponse { OrderProductResponseDetail Aggregate, Optional

Records the data being returned to the customer as a result of a product request.

Y Y OrderProductResponse { OrderProductResponseDetail { InquiryDetail Aggregate, Required

Records data that allows the customer to specify identifying information about the subject being inquired, e.g., the DUNS Number, the address, the telephone number.

Y Y OrderProductResponse { OrderProductResponseDetail { InquiryDetail { DUNSNumber Element, string, up to 15 chars. Pattern: {([0-9a-zA-Z]*)}., Optional

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

Y Y OrderProductResponse { OrderProductResponseDetail { InquiryDetail { CountryISOAlpha2Code Element, string, at least 2 chars. up to 2 chars., Optional

The two-letter country code, defined in the ISO 3166-1 scheme published by International Organization for Standardization (ISO)identifying the country of the inquired subject.

Y Y OrderProductResponse { OrderProductResponseDetail { InquiryDetail { PrincipalIdentificationNumberDetail Aggregate, Optional (Array)

An entry loop which can repeat multiple times to allow the recording of several different identifiers issued by organizations to uniquely identify the principal. The issuing organization may be a Registration Authority, Government Department or Commercial Enterprise, e.g., the Social Security Administration department.

Y Y OrderProductResponse { OrderProductResponseDetail { InquiryDetail { PrincipalIdentificationNumberDetail @DNBCodeTableNumber Attribute
Y Y OrderProductResponse { OrderProductResponseDetail { InquiryDetail { PrincipalIdentificationNumberDetail @DNBCodeValue Attribute
Y Y OrderProductResponse { OrderProductResponseDetail { InquiryDetail { PrincipalIdentificationNumberDetail @TypeText Attribute
Y Y OrderProductResponse { OrderProductResponseDetail { InquiryDetail { PrincipalIdentificationNumberDetail { PrincipalIdentificationNumber Element, string,, Optional

A number assigned by an external body or by D&B which either uniquely identifies or helps to identify an individual.

Y Y END: OrderProductResponse { OrderProductResponseDetail { InquiryDetail { PrincipalIdentificationNumberDetail Aggregate
Y Y END: OrderProductResponse { OrderProductResponseDetail { InquiryDetail Aggregate
Y Y OrderProductResponse { OrderProductResponseDetail { Product Aggregate, Required

Records data about the product ordered by the customer and data about the organization on which the customer has placed this order.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { DNBProductID Element, string, up to 64 chars., Optional

An alphanumeric string that uniquely identifies this product.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { LanguageCode Element, integer,eger up to 7 digits., Optional

A D&B code value that defines the language in which the requested product is fulfilled.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization Aggregate, Required

Records data about an organization, a legal or commercial entity established to provide products and/or services in the marketplace or to the community.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { SubjectHeader Aggregate, Required

Records high level information about the subject such as the primary language of the subject and the primary currency in which this subject trades. When the subject is an organizantion, this may also include details such as DUNS Number.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { SubjectHeader { DUNSNumber Element, string, up to 15 chars. Pattern: {([0-9a-zA-Z]*)}., Optional

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

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { SubjectHeader { NonMarketableReasonText Element, string, up to 256 chars., Optional (Array)

Text specifying the reason why the subject's data is not considered marketable by D&B.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { SubjectHeader { NonMarketableReasonText @DNBCodeValue Attribute
Y Y END: OrderProductResponse { OrderProductResponseDetail { Product { Organization { SubjectHeader Aggregate
Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Telecommunication Aggregate, Optional

Records information about the different modes of Telecommunication addresses used by a subject for external contact purposes. The modes of communication include telephone, fax, e-mail, web address.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Telecommunication { TelephoneNumber Aggregate, Optional (Array)

An entry loop which can allow multiple Telephone contact information used for voice communication with the subject.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Telecommunication { TelephoneNumber { TelecommunicationNumber Element, string, at least 1 chars. up to 50 chars., Required, [M+]

A sequence of digits used by the subject for voice communication in a public switched telephone network.This sequence of digits includes the area code or city code.Note: This number does not include the International Dialing Code and Domestic Dialing Code.

Monitor Path: //Organization /Telecommunication

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Telecommunication { TelephoneNumber { InternationalDialingCode Element, string, up to 7 chars., Optional, [M+]

The country calling code assigned by the International Telecommunication Union (ITU) required to connect to this Telecommunication Number of the subject country when dialing from outside the subject country; e.g., '1' for the US, '44' for the UK, '91' for India.

Monitor Path: //Organization /Telecommunication

Y Y END: OrderProductResponse { OrderProductResponseDetail { Product { Organization { Telecommunication { TelephoneNumber Aggregate
Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Telecommunication { FacsimileNumber Aggregate, Optional (Array)

An entry loop which can allow multiple Facsimile contact information used for data communication with the subject.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Telecommunication { FacsimileNumber { TelecommunicationNumber Element, string, at least 1 chars. up to 50 chars., Required, [M+]

A sequence of digits used by the subject for voice communication in a public switched telephone network.This sequence of digits includes the area code or city code.Note: This number does not include the International Dialing Code and Domestic Dialing Code.

Monitor Path: //Organization /Telecommunication

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Telecommunication { FacsimileNumber { InternationalDialingCode Element, string, up to 7 chars., Optional

The country calling code assigned by the International Telecommunication Union (ITU) required to connect to this Telecommunication Number of the subject country when dialing from outside the subject country; e.g., '1' for the US, '44' for the UK, '91' for India.

Y Y END: OrderProductResponse { OrderProductResponseDetail { Product { Organization { Telecommunication { FacsimileNumber Aggregate
Y Y END: OrderProductResponse { OrderProductResponseDetail { Product { Organization { Telecommunication Aggregate
Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location Aggregate, Optional

Records the address details for a subject. An address is the designation of a place where a subject can be located or may be communicated with, e.g., primary address, registered address, mailing address.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress Aggregate, Optional (Array)

An entry loop to allow the recording of a single primary or physical address of the subject in multiple languages and/or writing scripts. For an organization this is the principal address at which the organization is located. For an individual, this is the home address.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress { StreetAddressLine Aggregate, Optional (Array)

An entry loop which can repeat multiple times to allow the recording of several lines where each address line contains one or more named address elements. Examples of named address elements are Street Name, Street Number, Building Name, Estate Name. They are called “lines” because an addres can be divided into multiple lines. When there are multiple lines the sequence of the lines must be preserved.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress { StreetAddressLine { LineText Element, string, up to 240 chars., Required, [M+]

Text that records the street address components as it would be presented on an address label. This includes, but is not limited to, details such as street name, street number, building name, estate name.

Monitor Path: //Organization /Location /PrimaryAddress

Y Y END: OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress { StreetAddressLine Aggregate
Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress { PrimaryTownName Element, string, up to 64 chars., Optional, [M+]

The name of the town or city recognized by the Postal Authority for delivering mail.

Monitor Path: //Organization /Location /PrimaryAddress

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress { CountryISOAlpha2Code Element, string, at least 2 chars. up to 2 chars., Optional, [M+]

The two-letter country code, defined in the ISO 3166-1 scheme published by International Organization for Standardization (ISO), identifying the country for this address.

Monitor Path: //Organization /Location /PrimaryAddress

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress { TerritoryAbbreviatedName Element, string, up to 64 chars., Optional, [M+]

The shortened name of the locally governed area which forms part of a centrally governed nation. For example 'NJ' for the US State New Jersey within Country United States of America.

Monitor Path: //Organization /Location /PrimaryAddress

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress { PostalCode Element, string, up to 16 chars., Optional, [M+]

An identifier used by the local country Postal Authority to identify a particular geographic location. For example, in Belgium, Postal Code 9000 identifies the town of GHENT.

Monitor Path: //Organization /Location /PrimaryAddress

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress { CountyOfficialName Element, string, up to 64 chars., Optional
Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress { TerritoryOfficialName Element, string, up to 64 chars., Optional, [M+]

Monitor Path: //Organization /Location /PrimaryAddress

Y Y END: OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress Aggregate
Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { MailingAddress Aggregate, Optional (Array)

An entry loop which can repeat multiple times to allow the recording of address which is mainly utilized for the purpose of mail delivery. This usually includes a Post Office Box number or similar mailing details.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { MailingAddress { StreetAddressLine Aggregate, Optional (Array)

An entry loop which can repeat multiple times to allow the recording of several lines where each address line contains one or more named address elements. Examples of named address elements are Street Name, Street Number, Building Name, Estate Name. They are called “lines” because an addres can be divided into multiple lines. When there are multiple lines the sequence of the lines must be preserved.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { MailingAddress { StreetAddressLine { LineText Element, string, up to 240 chars., Required, [M+]

Text that records the street address components as it would be presented on an address label. This includes, but is not limited to, details such as street name, street number, building name, estate name.

Monitor Path: //Organization /Location /MailingAddress

Y Y END: OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { MailingAddress { StreetAddressLine Aggregate
Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { MailingAddress { PrimaryTownName Element, string, up to 64 chars., Optional, [M+]

The name of the town or city recognized by the Postal Authority for delivering mail.

Monitor Path: //Organization /Location /MailingAddress

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { MailingAddress { CountryISOAlpha2Code Element, string, at least 2 chars. up to 2 chars., Optional

The two-letter country code, defined in the ISO 3166-1 scheme published by International Organization for Standardization (ISO), identifying the country for this address.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { MailingAddress { TerritoryAbbreviatedName Element, string, up to 64 chars., Optional, [M+]

The shortened name of the locally governed area which forms part of a centrally governed nation. For example 'NJ' for the US State New Jersey within Country United States of America.

Monitor Path: //Organization /Location /MailingAddress

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { MailingAddress { PostalCode Element, string, up to 16 chars., Optional, [M+]

An identifier used by the local country Postal Authority to identify a particular geographic location. For example, in Belgium, Postal Code 9000 identifies the town of GHENT.

Monitor Path: //Organization /Location /MailingAddress

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { MailingAddress { CountyOfficialName Element, string, up to 64 chars., Optional, [M+]

Monitor Path: //Organization /Location /MailingAddress

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { MailingAddress { TerritoryOfficialName Element, string, up to 64 chars., Optional
Y Y END: OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { MailingAddress Aggregate
Y Y END: OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location Aggregate
Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationName Aggregate, Optional

Records the different names of the organization by which it is known as well as names of other organizations that have a similar name to this organization.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationName { OrganizationPrimaryName Aggregate, Optional (Array)

An entry loop which can repeat multiple times to allow the recording of a single name by which the organization is primarily known / identified in different languages and/or writing scripts.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationName { OrganizationPrimaryName @RegisteredNameIndicator Attribute
Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationName { OrganizationPrimaryName { OrganizationName Element, string, up to 256 chars., Required, [M]

Text recording a name of this organization in the specified language and/or writing script.

Monitor Path: //Organization /OrganizationName /OrganizationPrimaryName /OrganizationName

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationName { OrganizationPrimaryName { OrganizationName @LanguageCode Attribute
Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationName { OrganizationPrimaryName { OrganizationName @WritingScriptISOAlpha4Code Attribute
Y Y END: OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationName { OrganizationPrimaryName Aggregate
Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationName { TradeStyleName Aggregate, Optional (Array)

An entry loop which can repeat multiple times to allow the recording of a name which an organization trades under for commercial purposes, although its registered, legal name, used for contracts and other formal situations, may be another.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationName { TradeStyleName { OrganizationName Element, string, up to 256 chars., Required, [M+]

Text recording a name of this organization in the specified language and/or writing script.

Monitor Path: //Organization /OrganizationName /TradeStyleName

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationName { TradeStyleName { OrganizationName @LanguageCode Attribute
Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationName { TradeStyleName { OrganizationName @WritingScriptISOAlpha4Code Attribute
Y Y END: OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationName { TradeStyleName Aggregate
Y Y END: OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationName Aggregate
Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationDetail Aggregate, Optional

Records fundamental information about a Subject which may vary over time.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationDetail { FamilyTreeMemberRole Aggregate, Optional (Array)

An entry loop that can repeat multiple times to allow the recording of various parts that the Subject plays as a member of an ownership structured family tree.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationDetail { FamilyTreeMemberRole { FamilyTreeMemberRoleText Element, string, up to 256 chars., Optional

Text describing the part that the Subject plays as a member of an ownership structured family tree, e.g., a branch, division, a parent, headquarters, subsidiary, global ultimate, domestic ultimate.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationDetail { FamilyTreeMemberRole { FamilyTreeMemberRoleText @DNBCodeValue Attribute, [M+]

Monitor Path: //Organization /OrganizationDetail /FamilyTreeMemberRole

Y Y END: OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationDetail { FamilyTreeMemberRole Aggregate
Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationDetail { StandaloneOrganizationIndicator Element, boolean, Optional

When turned ON (set to TRUE) it indicates that this organization is not a member of a legal family tree. This means it cannot play the role of a subsidiary, parent, headquarters or branch; i.e., FamilyTreeMemberRoleText cannot be present.When turned OFF (set to FALSE) it indicates that this organization is a member of a legal family tree. In this condition the FamilyTreeMemberRoleText must be present.

Y Y END: OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationDetail Aggregate
Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement Aggregate, Optional

Records details of the Principals (e.g., President, Vice President, Directors) and Managers responsible for the business strategy, decision making and day to day running of the subjects operations. This includes names, addresses and identification numbers of the principals. Whilst a principal will usually be an individual in some countries it is legally acceptable for a registered business entity to act as a principal in another business. This excludes shareholders and similar owners who are not responsible for the management of the organization but includes proprietors and partners who, whilst owners, are also generally the principals running the business.Records details of the Principals (e.g., President, Vice President, Directors) and Managers responsible for the business strategy, decision making and day to day running of the subjects operations. This includes names, addresses and identification numbers of the principals. Whilst a principal will usually be an individual in some countries it is legally acceptable for a registered business entity to act as a principal in another business. This excludes shareholders and similar owners who are not responsible for the management of the organization but includes proprietors and partners who, whilst owners, are also generally the principals running the business.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal Aggregate, Optional (Array)

An entry loop which can repeat multiple times to allow recording of the information of each principal that are actively associated with the subject organization.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { PrincipalName Aggregate, Optional

Records the different names for the Principal.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { PrincipalName @type Attribute
Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { PrincipalName { NamePrefix Aggregate
Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { PrincipalName { NamePrefix { NamePrefixText Element, [M+]

Monitor Path: //Organization /PrincipalsAndManagement /CurrentPrincipal

Y Y END: OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { PrincipalName { NamePrefix Aggregate
Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { PrincipalName { FirstName Element, [M+]

Monitor Path: //Organization /PrincipalsAndManagement /CurrentPrincipal

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { PrincipalName { MiddleName Element, [M+]

Monitor Path: //Organization /PrincipalsAndManagement /CurrentPrincipal

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { PrincipalName { LastName Element, [M+]

Monitor Path: //Organization /PrincipalsAndManagement /CurrentPrincipal

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { PrincipalName { FullName Element, [M+]

Monitor Path: //Organization /PrincipalsAndManagement /CurrentPrincipal

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { PrincipalName { NameSuffix Aggregate
Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { PrincipalName { NameSuffix { NameSuffixText Element, [M+]

Monitor Path: //Organization /PrincipalsAndManagement /CurrentPrincipal

Y Y END: OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { PrincipalName Aggregate
Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { PrincipalAge Element, string, up to 3 chars., Optional, [M+]

Records the age of the principal in years.

Monitor Path: //Organization /PrincipalsAndManagement /CurrentPrincipal

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { Telecommunication Aggregate, Optional
Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { Telecommunication { TelephoneNumber Aggregate, Optional (Array)

An entry loop which can allow multiple Telephone contact information used for voice communication with the subject.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { Telecommunication { TelephoneNumber { TelecommunicationNumber Element, string, at least 1 chars. up to 50 chars., Required, [M+]

A sequence of digits used by the subject for voice communication in a public switched telephone network.This sequence of digits includes the area code or city code.Note: This number does not include the International Dialing Code and Domestic Dialing Code.

Monitor Path: //Organization /PrincipalsAndManagement /CurrentPrincipal

Y Y END: OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { Telecommunication { TelephoneNumber Aggregate
Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { Telecommunication { EmailAddress Aggregate, Optional (Array)

An entry loop which can allow multiple electronic mail addresses used for electronic messaging communication with the subject.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { Telecommunication { EmailAddress { TelecommunicationAddress Element, string, Optional, [M+]

Text recording the electronic mail address used by a subject by which the subject can transmit and or receive text messages, links, and files electronically, typically via a network, like the Internet.

Monitor Path: //Organization /PrincipalsAndManagement /CurrentPrincipal

Y Y END: OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { Telecommunication { EmailAddress Aggregate
Y Y END: OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { Telecommunication Aggregate
Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { EmploymentBiography Aggregate, Optional (Array)

An entry loop which can repeat multiple times to allow the recording of a concise description about the principal.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { EmploymentBiography { EmploymentBiographyText Element, string, Optional, [M+]

A free form text that provides a concise description about the principal. This may incude but is not restricted to the individual's current position, his former positions, roles that he performs in these positions.

Monitor Path: //Organization /PrincipalsAndManagement /CurrentPrincipal

NOTE: Deprecated

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { EmploymentBiography { NonSpecificSourceText Element, string, Optional, [M+]

Monitor Path: //Organization /PrincipalsAndManagement /CurrentPrincipal

NOTE: Deprecated

Y Y END: OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { EmploymentBiography Aggregate
Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { JobTitle Aggregate, Optional (Array)

An entry loop which can repeat multiple times to allow the recording of the name used by the organization to describe this person's job, e.g., Leader Global Communication, Manager National Technical Support Center.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { JobTitle { JobTitleText Element, string, up to 3000 chars., Optional, [M+]

Text that denotes a position held by the principal or manager.

Monitor Path: //Organization /PrincipalsAndManagement /CurrentPrincipal

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { JobTitle { JobTitleAdditionalInformationText Element, string, up to 3000 chars., Optional, [M+]

Text that denotes any additional information about the position held by the principal or manager which cannot be recorded as Job Title Text.

Monitor Path: //Organization /PrincipalsAndManagement /CurrentPrincipal

NOTE: Deprecated

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { JobTitle { StartDate Element, date, Optional, [M+]

The date when the principal or manager was appointed to this position. This is not necessarily the date when the principal or manager was first employed by the subject; this is simply the date when they moved to this position, e.g., due to a promotion.

Monitor Path: //Organization /PrincipalsAndManagement /CurrentPrincipal

NOTE: Deprecated

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { JobTitle { EndDate Element, date, Optional, [M+]

The date when the principal or manager ceased to hold this position. This is not necessarily the date when the principal or manager ceased to be employed by the subject; this is simply the date when they left this position, e.g., due to a promotion to a different position.

Monitor Path: //Organization /PrincipalsAndManagement /CurrentPrincipal

NOTE: Deprecated

Y Y END: OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { JobTitle Aggregate
Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { CurrentManagementResponsibility Aggregate, Optional (Array)

An entry loop which can repeat multiple times to allow the recording of the code values identifying the current business function of the principal represented as a standard Management Responsibility Code (MRC).

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { CurrentManagementResponsibility { ManagementResponsibilityText Element, Required

Text identifying the business function of the principal derived from a standard Management Responsibility Code (MRC).

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { CurrentManagementResponsibility { ManagementResponsibilityText @ManagementResponsibilityCode Attribute, [M+]

Monitor Path: //Organization /PrincipalsAndManagement /CurrentPrincipal

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { CurrentManagementResponsibility { StartDate Element, date, Optional, [M+]

The date when the principal or manager was appointed to this position. This is not necessarily the date when the principal or manager was first employed by the subject; this is simply the date when they moved to this position, e.g., due to a promotion.

Monitor Path: //Organization /PrincipalsAndManagement /CurrentPrincipal

NOTE: Deprecated

Y Y END: OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { CurrentManagementResponsibility Aggregate
N Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { FormerManagementResponsibility Aggregate, Optional (Array)

An entry loop which can repeat multiple times to allow the recording of the code values identifying the former business function of the principal represented as a standard Management Responsibility Code (MRC).

N Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { FormerManagementResponsibility { ManagementResponsibilityText Element, Required

Text identifying the business function of the principal derived from a standard Management Responsibility Code (MRC).

NOTE: Deprecated

N Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { FormerManagementResponsibility { ManagementResponsibilityText @ManagementResponsibilityCode Attribute, [M+]

Monitor Path: //Organization /PrincipalsAndManagement /CurrentPrincipal

N Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { FormerManagementResponsibility { StartDate Element, date, Optional, [M+]

The date when the principal or manager was appointed to this position. This is not necessarily the date when the principal or manager was first employed by the subject; this is simply the date when they moved to this position, e.g., due to a promotion.

Monitor Path: //Organization /PrincipalsAndManagement /CurrentPrincipal

NOTE: Deprecated

N Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { FormerManagementResponsibility { EndDate Element, date, Optional, [M+]

The date when the principal or manager ceased to hold this position. This is not necessarily the date when the principal or manager ceased to be employed by the subject; this is simply the date when they left this position, e.g., due to a promotion to a different position.

Monitor Path: //Organization /PrincipalsAndManagement /CurrentPrincipal

NOTE: Deprecated

N Y END: OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { FormerManagementResponsibility Aggregate
Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { PrincipalIdentificationNumberDetail Aggregate, Optional (Array)

An entry loop which can repeat multiple times to allow the recording of several different identification/registration numbers for the Principal.

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { PrincipalIdentificationNumberDetail @DNBCodeValue Attribute
Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { PrincipalIdentificationNumberDetail @TypeText Attribute
Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { PrincipalIdentificationNumberDetail { PrincipalIdentificationNumber Element, string, Optional

A number assigned by an external body or by D&B which either uniquely identifies or helps to identify an individual.

Y Y END: OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { PrincipalIdentificationNumberDetail Aggregate
Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { CurrentCompensation Aggregate, Optional
Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { CurrentCompensation { CompensationDate Element, date, Optional, [M+]

Monitor Path: //Organization /PrincipalsAndManagement /CurrentPrincipal

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { CurrentCompensation { CompensationDetail Aggregate, Optional (Array)
Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { CurrentCompensation { CompensationDetail { CompensationTypeText Element, string, up to 256 chars., Optional
Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { CurrentCompensation { CompensationDetail { CompensationTypeText @DNBCodeValue Attribute, [M+]

Monitor Path: //Organization /PrincipalsAndManagement /CurrentPrincipal

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { CurrentCompensation { CompensationDetail { CompensationAmount Element, decimal, Optional, [M+]

Monitor Path: //Organization /PrincipalsAndManagement /CurrentPrincipal

Y Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { CurrentCompensation { CompensationDetail { CompensationAmount @CurrencyISOAlpha3Code Attribute
Y Y END: OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { CurrentCompensation { CompensationDetail Aggregate
Y Y END: OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { CurrentCompensation Aggregate
N Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { FormerCompensation Aggregate, Optional (Array)
N Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { FormerCompensation { CompensationDate Element, date, Optional, [M+]

Monitor Path: //Organization /PrincipalsAndManagement /CurrentPrincipal

NOTE: Deprecated

N Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { FormerCompensation { CompensationDetail Aggregate, Optional (Array)
N Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { FormerCompensation { CompensationDetail { CompensationTypeText Element, string, up to 256 chars., Optional

NOTE: Deprecated

N Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { FormerCompensation { CompensationDetail { CompensationTypeText @DNBCodeValue Attribute, [M+]

Monitor Path: //Organization /PrincipalsAndManagement /CurrentPrincipal

N Y OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { FormerCompensation { CompensationDetail { CompensationAmount Element, decimal, Optional, [M+]

Monitor Path: //Organization /PrincipalsAndManagement /CurrentPrincipal

NOTE: Deprecated

N Y END: OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { FormerCompensation { CompensationDetail Aggregate
N Y END: OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal { FormerCompensation Aggregate
Y Y END: OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { CurrentPrincipal Aggregate
Y Y END: OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement Aggregate
Y Y END: OrderProductResponse { OrderProductResponseDetail { Product { Organization Aggregate
Y Y OrderProductResponse { OrderProductResponseDetail { Product { ArchiveDetail Aggregate, Optional
Y Y OrderProductResponse { OrderProductResponseDetail { Product { ArchiveDetail { PortfolioAssetID Element, Required
N Y OrderProductResponse { OrderProductResponseDetail { Product { ArchiveDetail { PortfolioAssetContainerID Element, long, Optional
Y Y END: OrderProductResponse { OrderProductResponseDetail { Product { ArchiveDetail Aggregate, Optional
Y Y END: OrderProductResponse { OrderProductResponseDetail { Product Aggregate, Optional (Array)
Y Y END: OrderProductResponse { OrderProductResponseDetail Aggregate
Y Y END: OrderProductResponse Aggregate

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.

Lists of possible values (when present) are subject to change. Additional values not presented in this documentation may be delivered in the response and should be anticipated in any implementation.

Empty/NULL Values

A NULL returned for an element indicates that the information was not provided to D&B when the related data items were collected. The absence of a value for a particular item should not be considered indicative of any implied value (e.g., NULL for a boolean indicator is NOT the same as a value of 'false').

Management Responsibility Codes

The following table contains the available values for this field.

CodeDescription
5Administration
10Business Development
15CEO
20CEO/President (Division, Region, or Unit)
25CFO
30Finance, Other
35CIO/CTO
40IS/IT, Other
45COO
50Operations, Other
55Chairman
60Controller/Comptroller
65Credit/Lending
70Customer Service
75Director/Board Member
80Engineering/Science
85General Manager
90HR
95International
100Investor Relations
105Legal
110Manufacturing
115Marketing, Top Level
120Marketing, Other
125President
130Product Development/Management
135Public Relations/Corporate Communications
140Purchasing
145Research and Development
150Sales, Top Level
155Sales, Other
160Secretary
165Strategic Planning
170Treasurer
180Vice Chairman
185VP
190EVP
195SVP
200SEVP
205Franchise Development
210Acquisitions
215Training and Development
220Distribution
225Supply Chain
230Quality Assurance
235Security/Safety
240Chief, other
245Media
255Product Engineering
260Logistics
265Partner
270Director, Non-board
275Manager

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: CM001-CM005, CM007-CM012, CM014, CM017, CM018, PD001, PD003, PD005, PD006, PD015, PD016,PD019 and SC001-SC012.

IMPORTANT: PD006 code - Applicable only for US/CA cases when TradeUpIndicator="true" for Risk packets.

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 D-U-N-S Number and product code are submitted on the same calendar day (which is based on Eastern Standard Time [GMT-5]).

Retrieving Archived Copies

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.

NOTE: The default value for ArchiveProductOptOutIndicator is 'true', indicating that the request will NOT be automatically archived.

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.

This product will also 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, etc.) in addition to the business elements listed.

STD ENH Name Description
Y Y Company Principal Additional Job Information Text that records any additional information about the position held by the principal or manager which cannot be recorded as Job Title Text.

PCM XPath: //Organization/ PrincipalsAndManagement/ CurrentPrincipal/ JobTitle/ JobTitleAdditionalInformationText

Y Y Company Principal Age A number recording the age of the principal in years.

PCM XPath: //Organization/ PrincipalsAndManagement/ CurrentPrincipal/ PrincipalAge

Y Y Company Principal Biographical Sketch (Principal) Text that provides a concise description about the principal. This may include, but is not restricted to, the individual's current position, his former positions, roles that he performs in these positions.

PCM XPath: //Organization/ PrincipalsAndManagement/ CurrentPrincipal/ EmploymentBiography/ EmploymentBiographyText

Y Y Company Principal Biographical Sketch Source Text recording the source from where the employment biographic information was obtained.

PCM XPath: //Organization/ PrincipalsAndManagement/ CurrentPrincipal/ EmploymentBiography/ NonSpecificSourceText

Y Y Company Principal Bonus Amount Bonus for the year, in requested currency

PCM XPath: //Organization/ PrincipalsAndManagement/ CurrentPrincipal/ CurrentCompensation/ CompensationDetail/ CompensationAmount

Y Y Company Principal Compensation Year Year of the current compensation details

PCM XPath: //Organization/ PrincipalsAndManagement/ CurrentPrincipal/ CurrentCompensation/ CompensationDate

Y Y Company Principal Email Address Text recording the principal's e-mail address.

PCM XPath: //Organization/ PrincipalsAndManagement/ CurrentPrincipal/ Telecommunication/ EmailAddress/ TelecommunicationAddress

Y Y Company Principal First Name Text recording the first name of the principal.

PCM XPath: //Organization/ PrincipalsAndManagement/ CurrentPrincipal/ PrincipalName/ FirstName

Y Y Company Principal Full Name Text recording the complete name of an individual who is primarily responsible for the decisions that drive the business.

PCM XPath: //Organization/ PrincipalsAndManagement/ CurrentPrincipal/ PrincipalName/ FullName

Y Y Company Principal Identification Number A number assigned by an external body or by D&B which either uniquely identifies or helps to identify the principal.

PCM XPath: //Organization/ PrincipalsAndManagement/ CurrentPrincipal/ PrincipalIdentificationNumberDetail/ PrincipalIdentificationNumber

Y Y Company Principal Job End Year The year when the principal or manager ceased to hold this position.

PCM XPath: //Organization/ PrincipalsAndManagement/ CurrentPrincipal/ JobTitle/ EndDate

Y Y Company Principal Job Start Year The year when the principal or manager was appointed to this position.

PCM XPath: //Organization/ PrincipalsAndManagement/ CurrentPrincipal/ JobTitle/ StartDate

Y Y Company Principal Job Title Text recording the job held by the principal or manager, e.g., Leader Global Communication, Manager National Technical Support Center.

PCM XPath: //Organization/ PrincipalsAndManagement/ CurrentPrincipal/ JobTitle/ JobTitleText

Y Y Company Principal Last Name Text recording the last name of the principal.

PCM XPath: //Organization/ PrincipalsAndManagement/ CurrentPrincipal/ PrincipalName/ LastName

Y Y Company Principal Management Responsibility Text identifying the current business function of the principal.

PCM XPath: //Organization/ PrincipalsAndManagement/ CurrentPrincipal/ CurrentManagementResponsibility/ ManagementResponsibilityText

Y Y Company Principal Middle Name Text recording the middle name of the principal.

PCM XPath: //Organization/ PrincipalsAndManagement/ CurrentPrincipal/ PrincipalName/ MiddleName

Y Y Company Principal Name Prefix Text that describes the correct form of address for this principal. For example, Dr., Professor, Lord, etc.

PCM XPath: //Organization/ PrincipalsAndManagement/ CurrentPrincipal/ PrincipalName/ NamePrefix/ NamePrefixText

Y Y Company Principal Name Suffix Text recording a familial suffix to the principal's name (e.g., Senior, Junior, III. ) or a professional/qualification suffix to the principal's name (e.g., MD, PhD etc.) or some other suffix to the principals name (e.g., Retired).

PCM XPath: //Organization/ PrincipalsAndManagement/ CurrentPrincipal/ PrincipalName/ NameSuffix/ NameSuffixText

Y Y Company Principal Salary Amount Salary for the year, excluding bonus in requested currency

PCM XPath: //Organization/ PrincipalsAndManagement/ CurrentPrincipal/ CurrentCompensation/ CompensationDetail/ CompensationAmount

Y Y Company Principal Telephone Number The telephone number of the principal.

PCM XPath: //Organization/ PrincipalsAndManagement/ CurrentPrincipal/ Telecommunication/ TelephoneNumber/ TelecommunicationNumber

Y Y Company Principal Total Salary Total compensation for the year, including any bonus or other compensation in requested currency

PCM XPath: //Organization/ PrincipalsAndManagement/ CurrentPrincipal/ CurrentCompensation/ CompensationDetail/ CompensationAmount

Y Y Management Responsibility Start Year The year when the principal or manager was appointed responsibility to this position.

PCM XPath: //Organization/ PrincipalsAndManagement/ CurrentPrincipal/ CurrentManagementResponsibility/ StartDate

Y Y Non Marketable Reason Text Text that specifies the reason for non marketability of the company.

PCM XPath: //Organization/ SubjectHeader/ NonMarketableReasonText

N Y Previous Company Principal Bonus Amount Bonus for a former year, in requested currency

PCM XPath: //Organization/ PrincipalsAndManagement/ CurrentPrincipal/ FormerCompensation/ CompensationDetail/ CompensationAmount

N Y Previous Company Principal Compensation Year Year of the previous compensation details

PCM XPath: //Organization/ PrincipalsAndManagement/ CurrentPrincipal/ FormerCompensation/ CompensationDate

N Y Previous Company Principal Management Responsibility Text identifying the former business function of the principal.

PCM XPath: //Organization/ PrincipalsAndManagement/ CurrentPrincipal/ FormerManagementResponsibility/ ManagementResponsibilityText

N Y Previous Company Principal Management Responsibility End Year The year when the principal or manager ceased to hold this position. This is not necessarily the date when the principal or manager ceased to be employed by the subject; this is simply the date when they left this position, e.g., due to a promotion.

PCM XPath: //Organization/ PrincipalsAndManagement/ CurrentPrincipal/ FormerManagementResponsibility/ EndDate

N Y Previous Company Principal Management Responsibility Start Year The year when the principal or manager was appointed to the previous position.

PCM XPath: //Organization/ PrincipalsAndManagement/ CurrentPrincipal/ FormerManagementResponsibility/ StartDate

N Y Previous Company Principal Salary Amount Salary for a former year, excluding bonus in requested currency

PCM XPath: //Organization/ PrincipalsAndManagement/ CurrentPrincipal/ FormerCompensation/ CompensationDetail/ CompensationAmount

N Y Previous Company Principal Total Salary Total compensation for a former year, including any bonus or other compensation in requested currency

PCM XPath: //Organization/ PrincipalsAndManagement/ CurrentPrincipal/ FormerCompensation/ CompensationDetail/ CompensationAmount

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.

Standard Elements

Whenever a D&B Direct data or report product request returns a single D-U-N-S Number, several business elements pertaining to that company will be included with the results.

These elements include D-U-N-S Number*, Organization Name, Primary Address** (including street, city, state, postal code, country), Mailing Address** (including street, city, state, postal code, county), Telephone Number, Fax Number, Trade Styles (up to five), Family Tree Role (HQ, branch), a Standalone Organization Indicator(true/false) and the PortfolioAssetID***.

All standard elements (with the exception of Family Tree Role and PortfolioAssetID) may be referenced by the Monitoring process.

* The D-U-N-S Number of the organization referenced in the results. In the case of a trade up, this will be the headquarters D-U-N-S Number.

** Addresses are returned as they are recieved by D&B and therefore may not conform to local postal formatting specifications.

*** This is an identification number that can be used to retrieve a given results package at a later date from the Product Request Archive (if/when that feature is enabled in a request).

Name Description
D-U-N-S Number 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). This DUNS Number represents the business entity.
Country Code The two-letter country code, defined by the International Organization for Standardization (ISO) ISO 3166-1 scheme identifying the country of the business entity.
County Name Text recording the name of the county in which the business is located.
Family Tree Member Role Text recording of various parts that the Subject plays as a member of an ownership structured family tree.
FAX Number The FAX number of the business.
FAX Number International Dialing Code The FAX number international dialing code of the business.
Mailing Country Code The two-letter country code, defined by the International Organization for Standardization (ISO) ISO 3166-1 scheme identifying the country which the business uses for mailing purposes.
Mailing County Name Text recording the name of the county which the business uses for mailing purposes.
Mailing Postal Code An identifier used by the local country Postal Authority which the business uses for mailing purposes.
Mailing Street Text recording an address which is mainly utilized for the purpose of mail delivery to the business. This usually includes a Post Office Box number or similar mailing details.
Mailing Street (2) Text recording an address which is mainly utilized for the purpose of mail delivery to the business. This usually includes a Post Office Box number or similar mailing details.
Mailing Territory Abbreviation Text recording the shortened name of the locally governed area which forms part of a centrally governed nation which the business uses for mailing purposes.
Mailing Territory Name Text recording the name of the locally governed area which forms part of a centrally governed nation which the business uses for mailing purposes.
Mailing Town Name The address number, or post office box number, and street name which a business uses for mailing purposes.
Postal Code An identifier used by the local country Postal Authority to identify where the business is located.
Primary Business Name Text recording of a single name by which the organization is primarily known or identified.
Standalone Organization Indicator When true indicates that this organization is not a member of a legal family tree. The Subject has no Parent Company, no subsidiaries or no branch/division locations.
Street Address Text recording the address number, or post office box number and street name where the business is located.
Street Address (2) Text recording the address number, or post office box number and street name where the business is located.
Telephone Number The telephone number of the business.
Telephone Number International Dialing Code The telephone number international dialing code of the business.
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 business is located.
Territory Name Text recording the name of the locally governed area which forms part of a centrally governed nation to identify where the business is located.
Town Name Text recording the name of a city, town, township, village, borough, etc. where the business is located.
Trade Style Name Text recording the name which an organization trades under for commercial purposes although its registered legal name used for contracts and other formal situations may be another name.

Product Notes

While this product is available for multiple counties, a country code is not a parameter on the product request.

The telephone number field(s) will be formatted based on the country code in the response.