Loading

Direct 2.0
Collapse

News and Social Media

Also known as Company News

Product Code(s)NEWS_MDA
Level(s)Standard
Monitoring AvailableNo
InterfaceSOAP
WSDLdownload
Format(s)XML
ServiceNewsAndMedia
OperationOrderProduct
{version}3.0
Initial ReleaseOctober 3, 2013

Returns news items for a given D-U-N-S Number.

Update History

  • January 25, 2019 (V3.0 SOAP/REST): SocialMediaDetail Aggregate and its elements have been dropped from the response.

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 December 14, 2018.

Overview

When requesting this data layer, you will be required to supply the valid D-U-N-S Number for a company and the appropriate product code. A trade up option exists to request data layers for the headquarters when the requested organization is a branch.

In addition, a date range, one or more category filters and/or social media platform may be included in the request. The social media platform may include: Facebook, Twitter, Wikipedia or YouTube; however, this criteria will not apply to the news items returned.

Possible values for the category filter include: Awards, Bankruptcy, Earnings Release, Executive Activity, Executive Announcement, Executive Quote, Expansion, Financial News, Funding, Management Change, Merger and Acquisition, New Alliance, New Product, Reduction, Regulation or Litigation, Restructure, and Wins.

Global Availability

The NEWS_MDA data layer is available for businesses domiciled in the following countries:

CountryISO Code
United States of AmericaUS
BelgiumBE
FranceFR
GermanyDE
ItalyIT
NetherlandsNL
PortugalPT
SpainES
United KingdomGB
AustraliaAU
New ZealandNZ
AndorraAD
AnguillaAI
Antigua & BarbudaAG
ArubaAW
BahamasBS
BarbadosBB
BelizeBZ
BermudaBM
BoliviaBO
British Virgin IslandsVG
CanadaCA
Cayman IslandsKY
ChileCL
ColombiaCO
Costa RicaCR
DenmarkDK
DominicaDM
Dominican RepublicDO
EcuadorEC
El SalvadorSV
Faero IslandsFO
FinlandFI
GreenlandGL
GrenadaGD
GuatemalaGT
GuyanaGY
HaitiHT
HondurasHN
IrelandIE
JamaicaJM
JapanJP
LuxembourgLU
MexicoMX
MonacoMC
MontserratMS
Netherlands AntillesAN
Bonaire, Sint Eustatius And SabaBQ
CuraçaoCW
Sint Maarten (dutch)SX
NicaraguaNI
NorwayNO
PanamaPA
Saint Kitts & NevisKN
Saint LuciaLC
Saint VincentVC
San MarinoSM
SurinameSR
SwedenSE
Taiwan (republic of China)TW
Trinidad And TobagoTT
Turks And CaicosTC
VenezuelaVE
AfghanistanAF
AlbaniaAL
AlgeriaDZ
American SamoaAS
AngolaAO
ArgentinaAR
ArmeniaAM
AustriaAT
AzerbaijanAZ
BahrainBH
BangladeshBD
Benin, Peoples Republic ofBJ
BhutanBT
Bosnia And HerzegovinaBA
BotswanaBW
BrazilBR
BruneiBN
BulgariaBG
Burkina FasoBF
Burma (myanmar)MM
BurundiBI
BelarusBY
Kampuchea (prev. Cambodia)KH
CameroonCM
Cape Verde, Republic ofCV
Central Africa RepublicCF
Chad, Republic ofTD
China, Peoples Republic ofCN
Christmas IslandCX
Comoros RepublicKM
Congo Democratic RepublicCD
Cook IslandsCK
CroatiaHR
CyprusCY
Turkish Republic of Northern CyprusXT
Czech RepublicCZ
DjiboutiDJ
EgyptEG
Equatorial GuineaGQ
EritreaER
EstoniaEE
EthiopiaET
Falkland IslandsFK
FijiFJ
French GuianaGF
French Polynesia/tahitiPF
Gabon RepublicGA
GambiaGM
GeorgiaGE
GhanaGH
GibraltarGI
GreeceGR
GuadeloupeGP
GuamGU
Guinea BissauGW
Guinea, Republic ofGN
Hong KongHK
HungaryHU
IcelandIS
IndiaIN
IndonesiaID
IranIR
IraqIQ
IsraelIL
Ivory Coast/cote D'ivoireCI
JordanJO
KazakhstanKZ
KenyaKE
KiribatiKI
Korea, Republic ofKR
KuwaitKW
KyrgyzstanKG
LaosLA
LatviaLV
LebanonLB
LesothoLS
LiberiaLR
LibyaLY
LiechtensteinLI
LithuaniaLT
MacauMO
MacedoniaMK
MadagasgarMG
MalawiMW
MalaysiaMY
MaldivesMV
MaliML
MaltaMT
Marianas IslandsMP
Marshall IslandsMH
MartiniqueMQ
MauritaniaMR
MauritiusMU
MoldovaMD
MontenegroME
MoroccoMA
MozambiqueMZ
NamibiaNA
NauruNR
NepalNP
New CaledoniaNC
NigerNE
NigeriaNG
Norfolk IslandNF
OmanOM
PakistanPK
Papua New GuineaPG
ParaguayPY
PeruPE
PhilippinesPH
PolandPL
QatarQA
Reunion IslandRE
RomaniaRO
Russian FederationRU
RwandaRW
Saint HelenaSH
Saint Pierre et MiquelonPM
Sao Tome & PrincipeST
Saudi ArabiaSA
SenegalSN
SerbiaRS
SeychellesSC
Sierra LeoneSL
SingaporeSG
SlovakiaSK
SloveniaSI
Solomon IslandsSB
SomaliaSO
South AfricaZA
Sri LankaLK
SudanSD
South SudanSS
SwazilandSZ
SwitzerlandCH
SyriaSY
TajhikstanTJ
TanzaniaTZ
ThailandTH
TogoTG
Tokelau IslandsTK
TongaTO
TunisiaTN
TurkeyTR
TurkmenistanTM
TuvaluTV
UgandaUG
UkraineUA
United Arab EmiratesAE
UruguayUY
UzbekistanUZ
VanuatuVU
VietnamVN
Western SamoaWS
YemenYE
ZambiaZM
ZimbabweZW
CongoCG
Holy See (Vatican City State)VA
KosovoXK
Micronesia, Federated States of FM
Timor-LesteTL
South 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 "News & Social Activity" 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.

Specification

Sample Request (NEWS_MDA)
<soapenv:Envelope xmlns:new="http://services.dnb.com/NewsAndMediaProductServiceV2.0" xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
   <soapenv:Header>
      <wsse:Security soapenv:mustUnderstand="1" xmlns:wsse="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-secext-1.0.xsd">
         <wsse:UsernameToken wsu:Id="UsernameToken-3" xmlns:wsu="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-wssecurity-utility-1.0.xsd">
            <wsse:Username>MyUserName</wsse:Username>
            <wsse:Password Type="http://docs.oasis-open.org/wss/2004/01/oasis-200401-wss-username-token-profile-1.0#PasswordText">MyPassword</wsse:Password>
         </wsse:UsernameToken>
      </wsse:Security>
   </soapenv:Header>
   <soapenv:Body>
      <new:OrderProductRequest ServiceVersionNumber="3.0">
         <TransactionDetail>
            <ApplicationTransactionID>sample</ApplicationTransactionID>
         </TransactionDetail>
         <OrderProductRequestDetail>
            <InquiryDetail>
               <DUNSNumber>804735132</DUNSNumber>
            </InquiryDetail>
            <ProductSpecification>
               <DNBProductID>NEWS_MDA</DNBProductID>
            </ProductSpecification>
            <ArchiveDetail>
               <ArchiveProductOptOutIndicator>false</ArchiveProductOptOutIndicator>
            </ArchiveDetail>
            <InquiryReferenceDetail>
               <CustomerReferenceText>sample</CustomerReferenceText>
               <CustomerBillingEndorsementText>sample</CustomerBillingEndorsementText>
            </InquiryReferenceDetail>
         </OrderProductRequestDetail>
      </new:OrderProductRequest>
   </soapenv:Body>
</soapenv:Envelope>
Name Characteristics
OrderProductRequest Aggregate
OrderProductRequest @ServiceVersionNumber Attribute
OrderProductRequest. TransactionDetail Aggregate, Optional

Records information necessary to process this request.

OrderProductRequest. TransactionDetail. ApplicationTransactionID string up to 64 chars., Optional

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

OrderProductRequest. TransactionDetail. 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.

OrderProductRequest. TransactionDetail. 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.

End: OrderProductRequest. TransactionDetail /Aggregate
OrderProductRequest. OrderProductRequestDetail Aggregate, Optional

Records data relating to requests for a product. This may include such details as the product required, the subject about which the product should be produced, the content of the product.

OrderProductRequest. OrderProductRequestDetail. 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.

OrderProductRequest. OrderProductRequestDetail. InquiryDetail. DUNSNumber 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).

End: OrderProductRequest. OrderProductRequestDetail. InquiryDetail /Aggregate
OrderProductRequest. OrderProductRequestDetail. ProductSpecification Aggregate, Required

Records data that allows the customer to specify the details of the requested product. This may include details such as the identifier of the product, the language in which the product needs to be rendered, the format in which the product needs to be rendered.

OrderProductRequest. OrderProductRequestDetail. ProductSpecification. DNBProductID string, Optional

An alphanumeric string that uniquely identifies the product being requested.

OrderProductRequest. OrderProductRequestDetail. ProductSpecification. TradeUpIndicator boolean, Optional

When true (set to 1) this denotes that the customer has requested that D&B return the data for the Headquarters when the requested organization is a Branch. When false (set to 0) this denotes that the customer has not requested that D&B return the data for the Headquarters when the requested organization is a Branch; however as this is the assumed condition there is no requirement to create this tag to represent this fact. Note: There are D&B WorldWide Network operations where the Headquarters information will be returned automatically, regardless of the customer request.

OrderProductRequest. OrderProductRequestDetail. ProductSpecification. NewsSpecification Aggregate, Optional

Records the parameters for refining the news information returned in the product

OrderProductRequest. OrderProductRequestDetail. ProductSpecification. NewsSpecification. PublishedFromDate date, Optional

The date from when the published news should be returned in the response.

OrderProductRequest. OrderProductRequestDetail. ProductSpecification. NewsSpecification. PublishedToDate date, Optional

The date till when the published news should be returned in the response

OrderProductRequest. OrderProductRequestDetail. ProductSpecification. NewsSpecification. CategoryText NewsCategoryTextEnum, Optional (Infinite)

Text that denotes the broader classification of the news based on the type of information.

End: OrderProductRequest. OrderProductRequestDetail. ProductSpecification. NewsSpecification /Aggregate
OrderProductRequest. OrderProductRequestDetail. ProductSpecification. SocialMediaSpecification Aggregate, Optional

Records the parameters for refining the social media information returned in the product.

OrderProductRequest. OrderProductRequestDetail. ProductSpecification. SocialMediaSpecification. SocialMediaPlatformName SocialMediaNameEnum, Optional (Infinite)

Name identifying the online service, platform, or site through which the subject creates and shares user-generated content.

End: OrderProductRequest. OrderProductRequestDetail. ProductSpecification. SocialMediaSpecification /Aggregate
End: OrderProductRequest. OrderProductRequestDetail. ProductSpecification /Aggregate
OrderProductRequest. OrderProductRequestDetail. ArchiveDetail Aggregate, Optional
OrderProductRequest. OrderProductRequestDetail. ArchiveDetail. ArchiveProductOptOutIndicator boolean, Optional

When true (set to 1), it indicates that the product being ordered is not to be stored. When false (set to 0), it 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.

OrderProductRequest. OrderProductRequestDetail. ArchiveDetail. ExtendArchivePeriodIndicator boolean, Optional

When true (set to 1), 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 (set to 0), the duration to archive the data is not to be extended.

OrderProductRequest. OrderProductRequestDetail. ArchiveDetail. PortfolioAssetContainerID long, Optional

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

End: OrderProductRequest. OrderProductRequestDetail. ArchiveDetail /Aggregate
OrderProductRequest. OrderProductRequestDetail. InquiryReferenceDetail Aggregate, Optional

Records data that allows the customer to specify information to be linked to the request in order to support subsequent order reconciliation.

OrderProductRequest. OrderProductRequestDetail. InquiryReferenceDetail. CustomerReferenceText 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.

OrderProductRequest. OrderProductRequestDetail. InquiryReferenceDetail. 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.

End: OrderProductRequest. OrderProductRequestDetail. InquiryReferenceDetail /Aggregate
End: OrderProductRequest. OrderProductRequestDetail /Aggregate
End: OrderProductRequest /Aggregate

Endpoint

Use the following endpoint with the downloadable WSDL to request this product.

SOAP (NewsAndMedia)
https://direct.dnb.com/NewsAndMediaProduct/V{version}WSDL

Testing

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.

Test Parameters
Dunsnumber: 804735132

PublishedFromDate: 2013-01-01
PublishedToDate: 2013-04-08

CategoryText: Awards
CategoryText: Bankruptcy
CategoryText: Earnings Release
CategoryText: Executive Activity
CategoryText: Executive Announcement
CategoryText: Executive Quote
CategoryText: Expansion
CategoryText: Financial News
CategoryText: Funding
CategoryText: Management Change
CategoryText: Merger and Acquisition
CategoryText: New Alliance
CategoryText: New Product
CategoryText: Reduction
CategoryText: Regulation or Litigation
CategoryText: Restructure
CategoryText: Wins

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.

Specification

The following is a list of the possible data fields returned by this operation in the XML 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 (NEWS_MDA)
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/">
   <soap-env:Body xmlns:soap-env="http://schemas.xmlsoap.org/soap/envelope/">
      <new:OrderProductResponse ServiceVersionNumber="3.0" xmlns:new="http://services.dnb.com/NewsAndMediaProductServiceV2.0">
         <TransactionDetail>
            <ApplicationTransactionID>sample</ApplicationTransactionID>
            <ServiceTransactionID>Id-061c9a5c0767b6d3c1532af5-2</ServiceTransactionID>
            <TransactionTimestamp>2019-03-26T08:33:10.977-04:00</TransactionTimestamp>
         </TransactionDetail>
         <TransactionResult>
            <SeverityText>Information</SeverityText>
            <ResultID>CM000</ResultID>
            <ResultText>Success</ResultText>
         </TransactionResult>
         <OrderProductResponseDetail>
            <InquiryDetail>
               <DUNSNumber>804735132</DUNSNumber>
               <CountryISOAlpha2Code>US</CountryISOAlpha2Code>
            </InquiryDetail>
            <Product>
               <DNBProductID>NEWS_MDA</DNBProductID>
               <Organization>
                  <SubjectHeader>
                     <DUNSNumber>804735132</DUNSNumber>
                  </SubjectHeader>
                  <Telecommunication>
                     <TelephoneNumber>
                        <TelecommunicationNumber>(650) 555-0000</TelecommunicationNumber>
                        <InternationalDialingCode>1</InternationalDialingCode>
                     </TelephoneNumber>
                  </Telecommunication>
                  <Location>
                     <PrimaryAddress>
                        <StreetAddressLine>
                           <LineText>492 KOLLER ST</LineText>
                        </StreetAddressLine>
                        <PrimaryTownName>SAN FRANCISCO</PrimaryTownName>
                        <CountryISOAlpha2Code>US</CountryISOAlpha2Code>
                        <TerritoryAbbreviatedName>CA</TerritoryAbbreviatedName>
                        <PostalCode>94110</PostalCode>
                        <CountyOfficialName>SAN FRANCISCO</CountyOfficialName>
                        <TerritoryOfficialName>California</TerritoryOfficialName>
                     </PrimaryAddress>
                  </Location>
                  <OrganizationName>
                     <OrganizationPrimaryName>
                        <OrganizationName>Gorman Manufacturing Company, Inc.</OrganizationName>
                     </OrganizationPrimaryName>
                  </OrganizationName>
                  <OrganizationDetail>
                     <FamilyTreeMemberRole>
                        <FamilyTreeMemberRoleText DNBCodeValue="12775">Global Ultimate</FamilyTreeMemberRoleText>
                     </FamilyTreeMemberRole>
                     <FamilyTreeMemberRole>
                        <FamilyTreeMemberRoleText DNBCodeValue="12774">Domestic Ultimate</FamilyTreeMemberRoleText>
                     </FamilyTreeMemberRole>
                     <FamilyTreeMemberRole>
                        <FamilyTreeMemberRoleText DNBCodeValue="9141">Parent/Headquarters</FamilyTreeMemberRoleText>
                     </FamilyTreeMemberRole>
                     <StandaloneOrganizationIndicator>false</StandaloneOrganizationIndicator>
                  </OrganizationDetail>
                  <News>
                     <NewsDetails>
                        <PublishedDateTimestamp>2019-03-26T11:26:17Z</PublishedDateTimestamp>
                        <SourceDescription>WN.com</SourceDescription>
                        <CategoryText>New Alliance</CategoryText>
                        <TitleText>State has not yet signed contract with Gorman for partnership at SUNY Poly</TitleText>
                        <ContentText>New York state officials have not yet signed a contract with Gorman for their latest partnership, a month and a half after announcing the project at the SUNY Polytechnic Institute campus in Albany. The project is waiting on approval from the state's Public Authorities Control Board. The board next meets in April, and the agenda has not yet been released.</ContentText>
                        <WebPageURL>https://article.wn.com/view/2019/03/26/State_has_not_yet_signed_contract_with_Gorman_for_partnership_a/</WebPageURL>
                     </NewsDetails>
                     <NewsDetails>
                        <PublishedDateTimestamp>2019-03-26T11:24:46Z</PublishedDateTimestamp>
                        <SourceDescription>GhanaWeb.com</SourceDescription>
                        <CategoryText>Executive Quote</CategoryText>
                        <CategoryText>New Alliance</CategoryText>
                        <TitleText>Delta3 International partners Gorman for maiden Africa InfoSec, IT leaders conference</TitleText>
                        <ContentText>Delta3 International, a cybersecurity firm with operations in Europe and Africa, has signed a partnership with Gorman, the global technology provider, for the upcoming Information Security (InfoSec) and IT Leaders Conference.
The conference, which comes off tomorrow, March 28, at the Marriot Hotel, Accra from 8:30am to 4:30pm is under the theme Mitigating Cyber Risks through Effective</ContentText>
                        <WebPageURL>https://www.ghanaweb.com/GhanaHomePage/business/Delta3-International-partners-Gorman-for-maiden-Africa-InfoSec-IT-leaders-conference-733228</WebPageURL>
                     </NewsDetails>
                  </News>
               </Organization>
               <ArchiveDetail>
                  <PortfolioAssetID>334212588</PortfolioAssetID>
               </ArchiveDetail>
            </Product>
            <InquiryReferenceDetail>
               <CustomerReferenceText>sample</CustomerReferenceText>
               <CustomerBillingEndorsementText>sample</CustomerBillingEndorsementText>
            </InquiryReferenceDetail>
         </OrderProductResponseDetail>
      </new:OrderProductResponse>
   </soap-env:Body>
</soapenv:Envelope>
Name Characteristics
OrderProductResponse Aggregate
OrderProductResponse @ServiceVersionNumber Attribute
OrderProductResponse. TransactionDetail Aggregate, Required

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

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

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

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

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

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.

End: OrderProductResponse. TransactionDetail Aggregate
OrderProductResponse. TransactionResult Aggregate, Required

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

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

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

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

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

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

Text that explains the outcome of the transaction.

OrderProductResponse. TransactionResult. ResultMessage Aggregate, Optional (Infinite)

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.

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

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

End: OrderProductResponse. TransactionResult. ResultMessage Aggregate
End: OrderProductResponse. TransactionResult Aggregate
OrderProductResponse. OrderProductResponseDetail Aggregate, Optional

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

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.

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

End: OrderProductResponse. OrderProductResponseDetail. InquiryDetail Aggregate
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.

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

An alphanumeric string that uniquely identifies this product.

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.

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.

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

End: OrderProductResponse. OrderProductResponseDetail. Product. Organization. SubjectHeader Aggregate
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.

OrderProductResponse. OrderProductResponseDetail. Product. Organization. Telecommunication. TelephoneNumber Aggregate, Optional (Infinite)

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

OrderProductResponse. OrderProductResponseDetail. Product. Organization. Telecommunication. TelephoneNumber. TelecommunicationNumber Element, string, at least 1 chars. up to 50 chars., Required

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.

OrderProductResponse. OrderProductResponseDetail. Product. Organization. Telecommunication. TelephoneNumber. 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.

END: OrderProductResponse. OrderProductResponseDetail. Product. Organization. Telecommunication. TelephoneNumber Aggregate
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Telecommunication. FacsimileNumber Aggregate, Optional (Infinite)

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

OrderProductResponse. OrderProductResponseDetail. Product. Organization. Telecommunication. FacsimileNumber. TelecommunicationNumber Element, string, at least 1 chars. up to 50 chars., Required

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.

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.

END: OrderProductResponse. OrderProductResponseDetail. Product. Organization. Telecommunication. FacsimileNumber Aggregate
End: OrderProductResponse. OrderProductResponseDetail. Product. Organization. Telecommunication Aggregate
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.

OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location. PrimaryAddress Aggregate, Optional (Infinite)

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.

OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location. PrimaryAddress. StreetAddressLine Aggregate, Optional (Infinite)

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.

OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location. PrimaryAddress. StreetAddressLine. LineText Element, string, up to 240 chars., Required

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.

END: OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location. PrimaryAddress. StreetAddressLine Aggregate
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location. PrimaryAddress. PrimaryTownName Element, string, up to 64 chars., Optional

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

OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location. PrimaryAddress. 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.

OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location. PrimaryAddress. TerritoryAbbreviatedName Element, string, up to 64 chars., Optional

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.

OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location. PrimaryAddress. PostalCode Element, string, up to 16 chars., Optional

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.

OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location. PrimaryAddress. CountyOfficialName Element, string, up to 64 chars., Optional
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location. PrimaryAddress. TerritoryOfficialName Element, string, up to 64 chars., Optional
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location. PrimaryAddress Aggregate
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location. MailingAddress Aggregate, Optional (Infinite)

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.

OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location. MailingAddress. StreetAddressLine Aggregate, Optional (Infinite)

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.

OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location. MailingAddress. StreetAddressLine. LineText Element, string, up to 240 chars., Required

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.

END: OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location. MailingAddress. StreetAddressLine Aggregate
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location. MailingAddress. PrimaryTownName Element, string, up to 64 chars., Optional

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

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.

OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location. MailingAddress. TerritoryAbbreviatedName Element, string, up to 64 chars., Optional

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.

OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location. MailingAddress. PostalCode Element, string, up to 16 chars., Optional

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.

OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location. MailingAddress. CountyOfficialName Element, string, up to 64 chars., Optional
OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location. MailingAddress. TerritoryOfficialName Element, string, up to 64 chars., Optional
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location. MailingAddress Aggregate
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization. Location Aggregate
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.

OrderProductResponse. OrderProductResponseDetail. Product. Organization. OrganizationName. OrganizationPrimaryName Aggregate, Optional (Infinite)

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.

OrderProductResponse. OrderProductResponseDetail. Product. Organization. OrganizationName. OrganizationPrimaryName. OrganizationName Element, string, up to 256 chars., Required

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

End: OrderProductResponse. OrderProductResponseDetail. Product. Organization. OrganizationName. OrganizationPrimaryName Aggregate
OrderProductResponse. OrderProductResponseDetail. Product. Organization. OrganizationName. TradeStyleName Aggregate, Optional (Infinite)

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.

OrderProductResponse. OrderProductResponseDetail. Product. Organization. OrganizationName. TradeStyleName. OrganizationName Element, string, up to 256 chars., Required

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

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

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

OrderProductResponse. OrderProductResponseDetail. Product. Organization. OrganizationDetail. FamilyTreeMemberRole Aggregate, Optional (Infinite)

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.

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.

OrderProductResponse. OrderProductResponseDetail. Product. Organization. OrganizationDetail. FamilyTreeMemberRole. FamilyTreeMemberRoleText @DNBCodeValue Attribute
OrderProductResponse. OrderProductResponseDetail. Product. Organization. OrganizationDetail. FamilyTreeMemberRole. FamilyTreeMemberRoleText @DNBCodeTableNumber Attribute
END: OrderProductResponse. OrderProductResponseDetail. Product. Organization. OrganizationDetail. FamilyTreeMemberRole Aggregate
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., Family Tree Member Role Text 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 Family Tree Member Role Text must be present.

END: OrderProductResponse. OrderProductResponseDetail. Product. Organization. OrganizationDetail Aggregate
OrderProductResponse. OrderProductResponseDetail. Product. Organization. News Aggregate, Optional

Records the details on news publications collected for this subject and the details of the online service, platform, or site that focuses on facilitating the building of social networks or social relations among people in which this subject is a participant.

OrderProductResponse. OrderProductResponseDetail. Product. Organization. News. NewsDetails Aggregate, Optional (Infinite)

An entry loop which can repeat multiple times to allow the recording of the news publications on this subject.

OrderProductResponse. OrderProductResponseDetail. Product. Organization. News. NewsDetails. PublishedDateTimestamp Element, Optional

The date and time when the news was published.

OrderProductResponse. OrderProductResponseDetail. Product. Organization. News. NewsDetails. SourceDescription Element, string, Optional

A textual description of the publication source for the news item.

OrderProductResponse. OrderProductResponseDetail. Product. Organization. News. NewsDetails. CategoryText Element, string, up to 256 chars., Optional (Infinite)

Text that denotes the broader classification of the news based on the type of information.

Possible values: Awards; Bankruptcy; Earnings Release; Executive Activity; Executive Announcement; Executive Quote; Expansion; Financial News; Funding; Management Change; Merger and Acquisition; New Alliance; New Product; Reduction; Regulation or Litigation; Restructure; Wins

OrderProductResponse. OrderProductResponseDetail. Product. Organization. News. NewsDetails. TitleText Element, string, up to 256 chars., Optional

Text that records the title of the news item.

OrderProductResponse. OrderProductResponseDetail. Product. Organization. News. NewsDetails. ContentText Element, string, up to 5000 chars., Optional

Text that records the body of the news item.

OrderProductResponse. OrderProductResponseDetail. Product. Organization. News. NewsDetails. WebPageURL Element, string, Optional

Text identifying the internet URL of the published news.

End: OrderProductResponse. OrderProductResponseDetail. Product. Organization. News. NewsDetails Aggregate
End: OrderProductResponse. OrderProductResponseDetail. Product. Organization. News Aggregate
End: OrderProductResponse. OrderProductResponseDetail. Product. Organization Aggregate
OrderProductResponse. OrderProductResponseDetail. Product. ArchiveDetail Aggregate, Optional
OrderProductResponse. OrderProductResponseDetail. Product. ArchiveDetail. PortfolioAssetID Element, Required
OrderProductResponse. OrderProductResponseDetail. Product. ArchiveDetail. PortfolioAssetContainerID Element, long, Optional
End: OrderProductResponse. OrderProductResponseDetail. Product. ArchiveDetail Aggregate
End: OrderProductResponse. OrderProductResponseDetail. Product Aggregate
OrderProductResponse. OrderProductResponseDetail. InquiryReferenceDetail Aggregate, Optional

Records data that allows the customer to specify information to be linked to the request in order to support subsequent order reconciliation.

OrderProductResponse. OrderProductResponseDetail. InquiryReferenceDetail. CustomerReferenceText Element, 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.

OrderProductResponse. OrderProductResponseDetail. InquiryReferenceDetail. CustomerBillingEndorsementText Element, 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.

End: OrderProductResponse. OrderProductResponseDetail. InquiryReferenceDetail Aggregate
End: OrderProductResponse. OrderProductResponseDetail Aggregate
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').

NOTE: There may be additional request and/or response elements specified in the WSDL that are not applicable for D&B Direct customers. Data elements that are not listed on this page are currently unused by this operation.

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, and SC001-SC012.

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.

Name Description
Company News Story Category Text that describes the broad-based category for the news item. Can repeat.

PCM XPath: //Organization/ News/ NewsDetails/ CategoryText

Company News Story Dateline The date and time when the company news item was published.

PCM XPath: //Organization/ News/ NewsDetails/ PublishedDateTimestamp

Company News Story Link Text that records the location of this Web-based content.

PCM XPath: //Organization/ News/ NewsDetails/ WebPageURL

Company News Story Source Text that describes the sources of the news item.

PCM XPath: //Organization/ News/ NewsDetails/ SourceDescription

Company News Story Text Text that contains the body of the news item.

PCM XPath: //Organization/ News/ NewsDetails/ ContentText

Company News Story Title Text that contains the title of the news item.

PCM XPath: //Organization/ News/ NewsDetails/ TitleText

Facebook Fans Number of Facebook fans.

PCM XPath: //Organization/ Telecommunication/ SocialMediaDetail/ SubscriberQuantity

Facebook User Name Facebook user name

PCM XPath: //Organization/ Telecommunication/ SocialMediaDetail/ UserContentKey

Twitter Display Name Display name of the organization in Twitter

PCM XPath: //Organization/ Telecommunication/ SocialMediaDetail/ UserDisplayName

Twitter Followers Number of Twitter followers for the organization.

PCM XPath: //Organization/ Telecommunication/ SocialMediaDetail/ SubscriberQuantity

Twitter User Name A more human readable version of the Twitter account id

PCM XPath: //Organization/ Telecommunication/ SocialMediaDetail/ UserContentKey

Wikipedia Page Link Text that records the location of this Web-based content.

PCM XPath: //Organization/ Telecommunication/ SocialMediaDetail/ WebPageURL

YouTube Channel YouTube channel

PCM XPath: //Organization/ Telecommunication/ SocialMediaDetail/ UserContentKey

YouTube Subscribers Number of YouTube subscribers.

PCM XPath: //Organization/ Telecommunication/ SocialMediaDetail/ SubscriberQuantity

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

The company news component of this product provides available news for an organization -- obtained from leading news sources globally as well as company websites -- includes news on executives, mergers and acquisitions, and special events that may have recently occurred. This information is updated daily.

The social media component of this product provides social media account profiles for an organizations, including such sources as Facebook, Twitter, YouTube, and Wikipedia, when they are available. This product does not return postings made on these social media platforms by the organization.