Cookies Settings

Loading

dnb-logo
Direct 2.0
Collapse

WB1784 Single Record

Also known as Detailed Company Profile - WB1784

This data layer provides details (one record at a time) comparable to the WorldBase Linked Prospect Record (WB1784) batch file, and is intended for customers familiar with the batch product.

New customers are encouraged to consume the Detailed Company Profile data layer(s).

Update History

  • May 07, 2021 (ALL SOAP & REST): Defect fix to remove the duplicate industry code from the product response.
  • April 26, 2019 (ALL SOAP & REST): New description has been updated for FullReportDate element.
  • March 29, 2019 (ALL SOAP & REST): TransferDUNSNumberRegistration aggregate and its elements have been suppressed from the response.
  • March 8, 2019 (v7.0 SOAP & REST): New Service version created for diversity changes to include additional indicator and detail section.
  • July 15, 2016 (ALL SOAP & REST): Industry Code Description has been added to DCP_SDMR and DCP_WB1784.
  • June 3, 2016 (v6.0 SOAP & REST): Return Transferred To DUNS Indicator has been added as a request parameter.
  • June 3, 2016 (v6.0 SOAP & REST): Subject Scope Text has been added and enabled.
  • March 11, 2016 (ALL SOAP & REST): NAICS 2012 (24664) industry codes are now delivered in addition to the NAICS 2007 (700) codes.
  • December 11, 2015 (v5.2 SOAP & REST): United Nations Standard Products and Services Code, D-U-N-S Transfer data, and Primary Local Activity Code are added. GlobalUltimateOrganization/PrimaryAddress/TerritoryOfficialName is also added and should be used in place of GlobalUltimateOrganization/PrimaryAddress/TerritoryName. The latter may not be included in future versions of this service.
  • October 9, 2015 (v5.1 SOAP & REST): Linkage Update Date has been added to Custom Products and DCP_WB1784.
  • October 9, 2015 (v5.1 SOAP & REST): Trade-up functionality now available for DCP_PREM, DCP_ENH, DCP_STD, DCP_SDMR and DCP_WB1784.
  • March 7, 2014 (v3.2 SOAP & REST): The Detailed Company Profile - WB1784 and Detailed Company Profile - SDMR data layers have been added to this service.
  • December 12, 2014 (v3.2 + earlier SOAP & REST): The field PrimaryAddress. TerritoryOfficialName should be used in place of PrimaryAddress. TerritoryName. The latter may not be included in future versions of this service.
  • July 15, 2016 (ALL SOAP & REST): Industry Code Description has been added to DCP_SDMR and DCP_WB1784.
  • June 3, 2016 (v6.0 SOAP & REST): Return Transferred To DUNS Indicator has been added as a request parameter.
  • June 3, 2016 (v6.0 SOAP & REST): Subject Scope Text has been added and enabled.
  • March 11, 2016 (ALL SOAP & REST): NAICS 2012 (24664) industry codes are now delivered in addition to the NAICS 2007 (700) codes.
  • December 11, 2015 (v5.2 SOAP & REST): United Nations Standard Products and Services Code, D-U-N-S Transfer data, and Primary Local Activity Code are added. GlobalUltimateOrganization/PrimaryAddress/TerritoryOfficialName is also added and should be used in place of GlobalUltimateOrganization/PrimaryAddress/TerritoryName. The latter may not be included in future versions of this service.
  • October 9, 2015 (v5.1 SOAP & REST): Linkage Update Date has been added to Custom Products and DCP_WB1784.
  • October 9, 2015 (v5.1 SOAP & REST): Trade-up functionality now available for DCP_PREM, DCP_ENH, DCP_STD, DCP_SDMR and DCP_WB1784.
  • March 7, 2014 (v3.2 SOAP & REST): The Detailed Company Profile - WB1784 and Detailed Company Profile - SDMR data layers have been added to this service.
  • December 12, 2014 (v3.2 + earlier SOAP & REST): The field PrimaryAddress. TerritoryOfficialName should be used in place of PrimaryAddress. TerritoryName. The latter may not be included in future versions of this service.

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 feature, a valid D&B D-U-N-S Number for a company and the appropriate product code will be required. For improved performance, include its country code.

A trade up option exists to request data for the headquarters when the requested organization is a branch.

NOTE: When ordering information for organizations located in Germany, customers are required to provide a valid order reason code.

Global Availability

The DCP_WB1784 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
TaiwanTW
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 Kong SARHK
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
Macao SARMO
North 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
EswatiniSZ
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 "Detailed Company Profile - WorldBase 1784 Layout" 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 (DCP_WB1784)
GET https://direct.dnb.com/V5.2/organizations/804735132/products/DCP_WB1784
Authorization: <My Token>
Name Characteristics
{version} Element
ApplicationTransactionID string, up to 64 chars, Optional

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

TransactionTimestamp date & time, 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).

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

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

Possible values: 39 [English]

OrderReasonCode integer, up to 7 digits, Optional

Possible values: 6332 [Credit Decision]; 6333 [Assessment of credit solvency for intended business connection]; 6334 [Assessment of credit solvency for ongoing business connection]; 6335 [Debt Collection]; 6336 [Commercial Credit Insurance]; 6337 [Insurance Contract]; 6338 [Leasing Agreement]; 6339 [Rental Agreement]

TradeUpIndicator boolean, Optional

When 'true' indicates that the customer has requested that D&B return the data for the headquarters when the requested organization is a Branch. When 'false' indicates 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.

Possible values: true; false

ArchiveProductOptOutIndicator boolean, Optional

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
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 char, 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 (Firmographic)
GET https://direct.dnb.com/V{version}/organizations/{DUNS}/products/{productID}

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.

D-U-N-S Number (Country Code)
804735132 (US); 362241452 (US); 214567885 (GB); 754683795 (AU); 481794956 (CH)

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: The D-U-N-S Number returned in the response will be a nine-digit zero-padded, numeric value.

Sample Response (DCP_WB1784)
{"OrderProductResponse": {
   "@ServiceVersionNumber": "5.2",
   "TransactionDetail":    {
      "ServiceTransactionID": "Id-e755dd56c34b040080150800554aad7d-2",
      "TransactionTimestamp": "2016-03-07T05:20:24.895-05:00"
   },
   "TransactionResult":    {
      "SeverityText": "Information",
      "ResultID": "CM000",
      "ResultText": "Success"
   },
   "OrderProductResponseDetail":    {
      "InquiryDetail":       {
         "DUNSNumber": "804735132",
         "CountryISOAlpha2Code": "US"
      },
      "Product":       {
         "DNBProductID": "DCP_WB1784",
         "Organization":          {
            "SubjectHeader":             {
               "DUNSNumber": "804735132",
               "LastUpdateDate": {"$": "2015-02-03"},
               "FullReportDate": "2015-02-03"
            },
            "Telecommunication": {"TelephoneNumber": [            {
               "TelecommunicationNumber": "(650) 555-0000",
               "InternationalDialingCode": "1"
            }]},
            "Location":             {
               "PrimaryAddress": [               {
                  "StreetAddressLine": [{"LineText": "492 KOLLER ST"}],
                  "PrimaryTownName": "San Francisco",
                  "CountryISOAlpha2Code": "US",
                  "TerritoryName": "California",
                  "TerritoryAbbreviatedName": "CA",
                  "PostalCode": "94110",
                  "CountyOfficialName": "San Francisco County",
                  "TerritoryOfficialName": "California",
                  "CountryOfficialName": "USA",
                  "CountryGroupName": "North America",
                  "PrimaryTownWorldBaseCode": 7139,
                  "CountyWorldBaseCode": 636,
                  "TerritoryWorldBaseCode": 9,
                  "RegisteredAddressIndicator": false,
                  "CountryWorldBaseCode": 805
               }],
               "MailingAddress": [               {
                  "CountryISOAlpha2Code": "US",
                  "CountryOfficialName": "USA",
                  "CountryGroupName": "North America",
                  "UndeliverableIndicator": false,
                  "TerritoryWorldBaseCode": 0,
                  "CountryWorldBaseCode": 0
               }]
            },
            "Financial": {"KeyFinancialFiguresOverview": [            {
               "StatementHeaderDetails":                {
                  "FinancialStatementToDate": {"$": "2014-12-31"},
                  "FinancialPeriodDuration": "P1Y"
               },
               "SalesRevenueAmount": [               {
                  "@CurrencyISOAlpha3Code": "USD",
                  "@ReliabilityText": "Actual",
                  "@UnitOfSize": "SingleUnits",
                  "$": 20839372
               }]
            }]},
            "OrganizationName": {"OrganizationPrimaryName": [{"OrganizationName": {"$": "Gorman Manufacturing Company, Inc."}}]},
            "OrganizationDetail":             {
               "FamilyTreeMemberRole":                [
                  {"FamilyTreeMemberRoleText":                   {
                     "@DNBCodeValue": 12775,
                     "$": "Global Ultimate"
                  }},
                  {"FamilyTreeMemberRoleText":                   {
                     "@DNBCodeValue": 12774,
                     "$": "Domestic Ultimate"
                  }},
                  {"FamilyTreeMemberRoleText":                   {
                     "@DNBCodeValue": 12773,
                     "$": "Parent"
                  }},
                  {"FamilyTreeMemberRoleText":                   {
                     "@DNBCodeValue": 12771,
                     "$": "Headquarters"
                  }}
               ],
               "StandaloneOrganizationIndicator": false,
               "ControlOwnershipDate": {"$": "1985"}
            },
            "RegisteredDetail":             {
               "LegalFormDetails": {"LegalFormText":                {
                  "@DNBCodeValue": 451,
                  "$": "Corporation"
               }},
               "OrganizationIdentificationNumberDetail": [               {
                  "@DNBCodeValue": 6863,
                  "@TypeText": "Federal Taxpayer Identification Number (US)",
                  "OrganizationIdentificationNumber": "123456789"
               }]
            },
            "IndustryCode": {"IndustryCode":             [
                              {
                  "@DNBCodeValue": 24658,
                  "@TypeText": "UN Standards Products & Services Code",
                  "IndustryCode": {"$": "82151502"},
                  "DisplaySequence": 1
               },
                              {
                  "@DNBCodeValue": 25838,
                  "@TypeText": "D&B Hoovers Industry Code",
                  "IndustryCode": {"$": "1068"},
                  "DisplaySequence": 1
               },
                              {
                  "@DNBCodeValue": 700,
                  "@TypeText": "NAICS",
                  "IndustryCode": {"$": "323111"},
                  "DisplaySequence": 1
               },
                              {
                  "@DNBCodeValue": 24664,
                  "@TypeText": "North American Industry Classification System 2012",
                  "IndustryCode": {"$": "323111"},
                  "DisplaySequence": 1
               },
                              {
                  "@DNBCodeValue": 21182,
                  "@TypeText": "UK SIC 2003",
                  "IndustryCode": {"$": "22.220"},
                  "DisplaySequence": 1
               },
                              {
                  "@DNBCodeValue": 3599,
                  "@TypeText": "D&B Standard Industry Code",
                  "IndustryCode": {"$": "27520000"},
                  "DisplaySequence": 1
               },
                              {
                  "@DNBCodeValue": 399,
                  "@TypeText": "US Standard Industry Code 1987 - 4 digit",
                  "IndustryCode": {"$": "2752"},
                  "DisplaySequence": 1
               }
            ]},
            "ActivitiesAndOperations": {"LineOfBusinessDetails": [{"LineOfBusinessDescription": {"$": "Commercial printing, lithographic"}}]},
            "EmployeeFigures":             {
               "IndividualEntityEmployeeDetails":                {
                  "TotalEmployeeQuantity": 110,
                  "ReliabilityText":                   {
                     "@DNBCodeValue": 9092,
                     "$": "Actual"
                  }
               },
               "ConsolidatedEmployeeDetails":                {
                  "TotalEmployeeQuantity": 125,
                  "EmployeeCategoryDetails": [{"EmployeeBasisText":                   {
                     "@DNBCodeValue": 9064,
                     "$": "Principals"
                  }}],
                  "ReliabilityText":                   {
                     "@DNBCodeValue": 9092,
                     "$": "Actual"
                  }
               }
            },
            "Linkage":             {
               "LinkageSummary": {"GlobalUltimateFamilyTreeLinkageCount": 8},
               "GlobalUltimateOrganization":                {
                  "DUNSNumber": "804735132",
                  "OrganizationPrimaryName": [{"OrganizationName": {"$": "GORMAN MANUFACTURING COMPANY, INC."}}],
                  "PrimaryAddress": [                  {
                     "StreetAddressLine": [{"LineText": "492 KOLLER ST"}],
                     "PrimaryTownName": "SAN FRANCISCO",
                     "CountryISOAlpha2Code": "US",
                     "TerritoryName": "California",
                     "TerritoryAbbreviatedName": "CA",
                     "PostalCode": "94110",
                     "TerritoryOfficialName": "California",
                     "CountryOfficialName": "UNITED STATES",
                     "CountryGroupName": "North America",
                     "PrimaryTownWorldBaseCode": 7139,
                     "CountyWorldBaseCode": 636,
                     "CountryWorldBaseCode": 805
                  }]
               },
               "DomesticUltimateOrganization":                {
                  "DUNSNumber": "804735132",
                  "OrganizationPrimaryName": [{"OrganizationName": {"$": "GORMAN MANUFACTURING COMPANY, INC."}}],
                  "PrimaryAddress": [                  {
                     "StreetAddressLine": [{"LineText": "492 KOLLER ST"}],
                     "PrimaryTownName": "SAN FRANCISCO",
                     "CountryISOAlpha2Code": "US",
                     "TerritoryAbbreviatedName": "CA",
                     "PostalCode": "94110",
                     "TerritoryOfficialName": "California",
                     "PrimaryTownWorldBaseCode": 7139,
                     "CountyWorldBaseCode": 636,
                     "CountryWorldBaseCode": 805
                  }]
               },
               "FamilyTreeHierarchyLevel": 1,
               "LinkageUpdateDate": {"$": "2015-09-14"}
            }
         },
         "ArchiveDetail": {"PortfolioAssetID": 70481232}
      }
   }
}}
Name Characteristics
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 string, up to 64 chars, Optional

An alphanumeric string that uniquely identifies this product.

OrderProductResponse { OrderProductResponseDetail { Product { LanguageCode integer, up to 7 digits, Optional

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

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 string, up to 15 chars Pattern: {([0-9a-zA-Z]*)}, Optional [C] [M]

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

OrderProductResponse { OrderProductResponseDetail { Product { Organization { SubjectHeader { TransferDUNSNumberRegistration { TransferredFromDUNSNumber string, up to 15 chars Pattern: {([0-9a-zA-Z]*)}, Optional [C] [M+]

This is the D-U-N-S number of the subject that is deleted from the host database.

Monitor Path: //Organization /SubjectHeader /TransferDUNSNumberRegistration

OrderProductResponse { OrderProductResponseDetail { Product { Organization { SubjectHeader { LastUpdateDate date, Optional [C] [M]

The date when the subject's record was last updated on D&B's system.

OrderProductResponse { OrderProductResponseDetail { Product { Organization { SubjectHeader { FullReportDate date | year | year & month, Optional [C] [M]

The date when the data recorded in the D&B Database on this subject was fully updated.

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 { PrimaryTownName string, up to 64 chars, Optional [C] [M+]

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

Monitor Path: //Organization /Location /PrimaryAddress

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress { CountyOfficialName string, up to 64 chars, Optional [C] [M+]

The legal name of the primary administrative division within a Territory or Country. Clarification Note: As a guiding principle this is a geographic area which would be classified as a Province (except Canada) or a County. In the U.S. this would be a county within a State. In the UK this would be a county in one of the Home Nations. In Republic Of Ireland, this would be a county and there would be no Territory.

Monitor Path: //Organization /Location /PrimaryAddress

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress { PostalCode string, up to 16 chars, Optional [C] [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

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress { TerritoryOfficialName string, up to 64 chars, Optional [C] [M+]

The legal name of the locally governed area which forms part of a centrally governed nation. Clarification Note: As a guiding principle this is a geographic area which could theoretically exist as a separate nation. In the U.S. this would be a State. In the UK this would be one of the Home Nations.

Monitor Path: //Organization /Location /PrimaryAddress

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress { TerritoryAbbreviatedName string, up to 64 chars, Optional [C] [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

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress { RegisteredAddressIndicator boolean, Optional [C] [M+]

When TRUE (set to 1)it indicates that the Primary Address which has been presented is also the Registered Address. When FALSE (set to 0)it indicates that the Primary Address which has been presented is not a Registered Address.

Monitor Path: //Organization /Location /PrimaryAddress

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress { CountryGroupName string, up to 64 chars, Optional [C] [M+]

The name of the region as defined by Damp;B for this address, i.e., North America, Latin America, Europe, Asia Pacific, Middle East, Africa.

Monitor Path: //Organization /Location /PrimaryAddress

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress { CountryOfficialName string, up to 64 chars, Optional [C] [M+]

The legal name of the country for this address.

Monitor Path: //Organization /Location /PrimaryAddress

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress { PrimaryTownWorldBaseCode integer, up to 32 digits, Optional [C] [M+]

The D&B WorldBase code value that identifies the town or the city recognized by the Postal Authority for delivering mail.

Monitor Path: //Organization /Location /PrimaryAddress

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress { TerritoryWorldBaseCode integer, up to 32 digits, Optional [C] [M+]

The D&B WorldBase code value that identifies locally governed area which forms part of a centrally governed nation as received by D&B. Clarification Note: As a guiding principle this is a geographic area which could theoretically exist as a separate nation. In the U.S. this would be a State. In the UK this would be one of the Home Nations.

Monitor Path: //Organization /Location /PrimaryAddress

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress { CountryWorldBaseCode integer, up to 3 digits, Optional [C]

The D&B three digit WorldBase code value that identifies country where the business is located.

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress { CountyWorldBaseCode integer, up to 32 digits, Optional [C] [M+]

The D&B WorldBase code value that identifies the primary administrative division within a Territory or Country.

Monitor Path: //Organization /Location /PrimaryAddress

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { MailingAddress { PrimaryTownName string, up to 64 chars, Optional [C] [M+]

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

Monitor Path: //Organization /Location /MailingAddress

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

The legal name of the primary administrative division within a Territory or Country. Clarification Note: As a guiding principle this is a geographic area which would be classified as a Province (except Canada) or a County. In the U.S. this would be a county within a State. In the UK this would be a county in one of the Home Nations. In Republic Of Ireland, this would be a county and there would be no Territory.

Monitor Path: //Organization /Location /MailingAddress

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { MailingAddress { PostalCode string, up to 16 chars, Optional [C] [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

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { MailingAddress { TerritoryOfficialName string, up to 64 chars, Optional [C] [M+]

The legal name of the locally governed area which forms part of a centrally governed nation. Clarification Note: As a guiding principle this is a geographic area which could theoretically exist as a separate nation. In the U.S. this would be a State. In the UK this would be one of the Home Nations.

Monitor Path: //Organization /Location /MailingAddress

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { MailingAddress { TerritoryAbbreviatedName string, up to 64 chars, Optional [C] [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

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { MailingAddress { CountryOfficialName string, up to 64 chars, Optional [C] [M+]

The legal name of the country for this address.

Monitor Path: //Organization /Location /MailingAddress

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { MailingAddress { PrimaryTownWorldBaseCode integer, up to 32 digits, Optional [C] [M+]

The D&B WorldBase code value that identifies the town or the city recognized by the Postal Authority for delivering mail.

Monitor Path: //Organization /Location /MailingAddress

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { MailingAddress { TerritoryWorldBaseCode integer, up to 32 digits, Optional [C] [M+]

The D&B WorldBase code value that identifies locally governed area which forms part of a centrally governed nation as received by D&B. Clarification Note: As a guiding principle this is a geographic area which could theoretically exist as a separate nation. In the U.S. this would be a State. In the UK this would be one of the Home Nations.

Monitor Path: //Organization /Location /MailingAddress

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { MailingAddress { CountryWorldBaseCode integer, up to 3 digits, Optional [C] [M+]

The D&B three digit WorldBase code value that identifies country where the business is located.

Monitor Path: //Organization /Location /MailingAddress

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { MailingAddress { CountryGroupName string, up to 64 chars, Optional [C] [M+]

The name of the region as defined by Damp;B for this address, i.e., North America, Latin America, Europe, Asia Pacific, Middle East, Africa.

Monitor Path: //Organization /Location /MailingAddress

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { MailingAddress { CountyWorldBaseCode integer, up to 32 digits, Optional [C] [M]

The D&B WorldBase code value that identifies the primary administrative division within a Territory or Country.

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Telecommunication { TelephoneNumber { TelecommunicationNumber string, at least 1 char, up to 50 chars, Required [C] [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.

NOTE: Data provided is formatted as per national conventions for each country

Monitor Path: //Organization /Telecommunication

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Telecommunication { TelephoneNumber { InternationalDialingCode string, up to 7 chars, Optional [C] [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

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Telecommunication { FacsimileNumber { TelecommunicationNumber string, at least 1 char, up to 50 chars, Required [C] [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.

NOTE: Data provided is formatted as per national conventions for each country

Monitor Path: //Organization /Telecommunication

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Financial { KeyFinancialFiguresOverview { SalesRevenueAmount decimal, Optional (Infinite) [C] [M]

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

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Financial { KeyFinancialFiguresOverview { SalesRevenueAmount @CurrencyISOAlpha3Code Attribute
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Financial { KeyFinancialFiguresOverview { SalesRevenueAmount @ReliabilityText Attribute
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 string, up to 256 chars, Required [C] [M]

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 string, up to 256 chars, Required [C] [M+]

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

Monitor Path: //Organization /OrganizationName /TradeStyleName

OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationName { TradeStyleName { DisplaySequence integer, up to 3 digits, Optional [C]

A numeric value used to identify the relative importance of this Organization Name compared to the other Organization Names for this organization that are of the same type (e.g., Trading Style). The lower the importance level number, the more important (preferred) is an Organization Name.

END: OrderProductResponse } OrderProductResponseDetail } Product } Organization } OrganizationName } TradeStyleName /Aggregate
END: OrderProductResponse } OrderProductResponseDetail } Product } Organization } OrganizationName /Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationDetail { FamilyTreeMemberRole { FamilyTreeMemberRoleText string, up to 256 chars, Optional [C] [M+]

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.

Possible values: Subsidiary; Branch; Division; Headquarters; Parent; Domestic Ultimate; Global Ultimate

Monitor Path: //Organization /OrganizationDetail /FamilyTreeMemberRole

OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationDetail { FamilyTreeMemberRole { FamilyTreeMemberRoleText @DNBCodeValue integer, up to 7 digits, Attribute (1x)

Possible values: 9159 (Subsidiary); 12769 (Branch); 12770 (Division); 12771 (Headquarters); 12773 (Parent); 12774 (Domestic Ultimate); 12775 (Global Ultimate)

OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationDetail { StandaloneOrganizationIndicator boolean, Optional [C] [M]

When 'true' 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 'false' indicates that this organization is a member of a legal family tree. In this condition the FamilyTreeMemberRoleText must be present.

OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationDetail { ControlOwnershipDate date, Optional [C] [M]

The date when the current owners took over this business.

OrderProductResponse { OrderProductResponseDetail { Product { Organization { RegisteredDetail { OrganizationIdentificationNumberDetail Aggregate, Optional (Infinite)

An entry loop which can repeat multiple times to allow recording of the identifiers issued by organizations to uniquely identify subjects. The issuing organization may be a Registration Authority, Government Department or Commercial Enterprise E.g. Chamber of Commerce numbers, VAT numbers, etc.

OrderProductResponse { OrderProductResponseDetail { Product { Organization { RegisteredDetail { OrganizationIdentificationNumberDetail @DNBCodeTableNumber integer, up to 7 digits, Attribute (1x)
OrderProductResponse { OrderProductResponseDetail { Product { Organization { RegisteredDetail { OrganizationIdentificationNumberDetail { OrganizationIdentificationNumber string, at least 1 char, up to 40 chars, Required [C] [M+]

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

Monitor Path: //Organization /RegisteredDetail /OrganizationIdentificationNumberDetail@DNBCodeValue /OrganizationIdentificationNumber

OrderProductResponse { OrderProductResponseDetail { Product { Organization { RegisteredDetail { LegalFormDetails { LegalFormText string, up to 256 chars, Required [C] [M+]

Text that describes the legal form or structure of a business, as registered with government authorities, e.g., partnership, corporation, private limited company, government department, proprietorship.

Possible values: Code Table 197; Code Table 0 (with a selection of 0 Unknown)

Monitor Path: //Organization /RegisteredDetail /LegalFormDetails /LegalFormText@DNBCodeValue

OrderProductResponse { OrderProductResponseDetail { Product { Organization { IndustryCode { IndustryCode Aggregate, Optional (Infinite)

An entry loop which can repeat multiple times to allow the recording of several business activities in which an organization is actively engaged using standardized coding schemes such as European NACE and U.S. Standard Industry Classifications (SIC).

OrderProductResponse { OrderProductResponseDetail { Product { Organization { IndustryCode { IndustryCode { IndustryCode string, up to 16 chars, Required [C] [M+]

An alphanumeric value identifying a business activity based on the scheme specified by the typeText. For instance, 1611 represents the highway and street construction industry in the U.S. SIC (Standard Industrial Classification) system. Clarification Note: These are generally external codes created by an external authoritative body, like the U.S. Office of Management and Budget (OMB), but D&B may have created extensions to more precisely define an activity, as in the case of the SIC 2+2 (the last 4 digits of an 8-digit SIC).

Monitor Path: //Organization /IndustryCode /IndustryCode@DNBCodeValue

OrderProductResponse { OrderProductResponseDetail { Product { Organization { IndustryCode { IndustryCode { IndustryCodeDescription string, Required
OrderProductResponse { OrderProductResponseDetail { Product { Organization { IndustryCode { IndustryCode { IndustryCodeDescription @LanguageCode attribute, Required
OrderProductResponse { OrderProductResponseDetail { Product { Organization { IndustryCode { IndustryCode { IndustryCodeDescription @WritingScriptISOAlpha4Code attribute, Required
OrderProductResponse { OrderProductResponseDetail { Product { Organization { ActivitiesAndOperations { LineOfBusinessDetails { LineOfBusinessDescription string, up to 3000 chars, Optional [C] [M+]

Records the textual description of operations continued by a business.

Monitor Path: //Organization /ActivitiesAndOperations /LineOfBusinessDetails

OrderProductResponse { OrderProductResponseDetail { Product { Organization { ActivitiesAndOperations { ImportDetails { ImportIndicator boolean, Optional [C] [M]

When 'true' indicates that the subject company imports a quantity of goods from other countries.

OrderProductResponse { OrderProductResponseDetail { Product { Organization { ActivitiesAndOperations { ExportDetails { ExportIndicator boolean, Optional [C] [M]

When 'true' indicates that the subject company exports a quantity of goods to other countries.

OrderProductResponse { OrderProductResponseDetail { Product { Organization { ActivitiesAndOperations { SubjectIsAgentDetails { AgentIndicator boolean, Optional [C] [M]

When 'true' indicates that the subject acts as an agent promoting the goods or services of another organization, e.g., Sales Agent, Purchasing Agent. When 'false' indicates that the subject does not act as an agent of another organization.

OrderProductResponse { OrderProductResponseDetail { Product { Organization { EmployeeFigures { IndividualEntityEmployeeDetails { TotalEmployeeQuantity long, Optional [C] [M]

A number that defines how many people are directly engaged and paid by the organization to perform or support its business operations.

OrderProductResponse { OrderProductResponseDetail { Product { Organization { EmployeeFigures { IndividualEntityEmployeeDetails { ReliabilityText string, up to 256 chars, Optional [C] [M+]

Text that describes the integrity of the employee figures, e.g. actual, estimated, modeled.

Monitor Path: //Organization /EmployeeFigures /IndividualEntityEmployeeDetails /ReliabilityText@DNBCodeValue

OrderProductResponse { OrderProductResponseDetail { Product { Organization { EmployeeFigures { ConsolidatedEmployeeDetails { TotalEmployeeQuantity long, Optional [C] [M]

A number that defines how many people are directly engaged and paid by the organization to perform or support its business operations.

OrderProductResponse { OrderProductResponseDetail { Product { Organization { EmployeeFigures { ConsolidatedEmployeeDetails { ReliabilityText string, up to 256 chars, Optional [C] [M+]

Text that describes the integrity of the employee figures, e.g. actual, estimated, modeled.

Monitor Path: //Organization /EmployeeFigures /ConsolidatedEmployeeDetails /ReliabilityText@DNBCodeValue

OrderProductResponse { OrderProductResponseDetail { Product { Organization { EmployeeFigures { ConsolidatedEmployeeDetails { EmployeeCategoryDetails { EmployeeBasisText string, up to 256 chars, Optional [C] [M+]

Text that describes what type of employees has been included in the calculation of the Employee Quantity on the basis of their employment contract, e.g. Principals, Part Time Workers.

Monitor Path: //Organization /EmployeeFigures /ConsolidatedEmployeeDetails /EmployeeCategoryDetails /EmployeeBasisText@DNBCodeValue

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { LinkageSummary { GlobalUltimateFamilyTreeLinkageCount integer, up to 8 digits, Optional [C] [M]

This is the number of linkages in the upward and downward directions of the entire Family tree where the subject belongs to. Starting from global ultimate company.

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { GlobalUltimateOrganization { DUNSNumber string, up to 15 chars Pattern: {([0-9a-zA-Z]*)}, Optional [C] [M]

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

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { GlobalUltimateOrganization { OrganizationPrimaryName { OrganizationName string, up to 256 chars, Required [C] [M]

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

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { GlobalUltimateOrganization { CountryISOAlpha2Code string, at least 2 chars, up to 2 chars, Optional [C] [M]

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.

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { GlobalUltimateOrganization { PrimaryAddress { StreetAddressLine { LineText string, up to 240 chars, Required [C] [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 /Linkage /GlobalUltimateOrganization /PrimaryAddress

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { GlobalUltimateOrganization { PrimaryAddress { PrimaryTownName string, up to 64 chars, Optional [C] [M+]

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

Monitor Path: //Organization /Linkage /GlobalUltimateOrganization /PrimaryAddress

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { GlobalUltimateOrganization { PrimaryAddress { TerritoryNamestring, up to 128 chars, Optional [C] [M+]

The name of the locally governed area which forms part of a centrally governed nation as received by D&B. Clarification Note: As a guiding principle this is a geographic area which could theoretically exist as a separate nation. In the U.S. this would be a State. In the UK this would be one of the Home Nations.

Note: This element will deliver the same result as Organization { Linkage { GlobalUltimateOrganization { PrimaryAddress { TerritoryOfficialName.

Monitor Path: //Organization /Linkage /GlobalUltimateOrganization /PrimaryAddress

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { GlobalUltimateOrganization { PrimaryAddress { TerritoryOfficialName string, up to 128 chars, Optional [C] [M+]

The name of the locally governed area which forms part of a centrally governed nation as received by D&B. Clarification Note: As a guiding principle this is a geographic area which could theoretically exist as a separate nation. In the U.S. this would be a State. In the UK this would be one of the Home Nations.

Monitor Path: //Organization /Linkage /GlobalUltimateOrganization /PrimaryAddress

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { GlobalUltimateOrganization { PrimaryAddress { TerritoryAbbreviatedName string, up to 64 chars, Optional [C] [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 /Linkage /GlobalUltimateOrganization /PrimaryAddress

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { GlobalUltimateOrganization { PrimaryAddress { PostalCode string, up to 16 chars, Optional [C] [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 /Linkage /GlobalUltimateOrganization /PrimaryAddress

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { GlobalUltimateOrganization { PrimaryAddress { CountryOfficialName string, up to 64 chars, Optional [C] [M+]

Monitor Path: //Organization /Linkage /GlobalUltimateOrganization /PrimaryAddress

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { GlobalUltimateOrganization { PrimaryAddress { PrimaryTownWorldBaseCode integer, up to 32 digits, Optional [C] [M+]

Monitor Path: //Organization /Linkage /GlobalUltimateOrganization /PrimaryAddress

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { GlobalUltimateOrganization { PrimaryAddress { CountryWorldBaseCode integer, up to 3 digits, Optional [C] [M+]

The D&B three digit WorldBase code value that identifies country where the business is located.

Monitor Path: //Organization /Linkage /GlobalUltimateOrganization /PrimaryAddress

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { GlobalUltimateOrganization { PrimaryAddress { CountryGroupName string, up to 64 chars, Optional [C] [M+]

Monitor Path: //Organization /Linkage /GlobalUltimateOrganization /PrimaryAddress

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { GlobalUltimateOrganization { PrimaryAddress { CountyWorldBaseCode integer, up to 32 digits, Optional [C] [M+]

Monitor Path: //Organization /Linkage /ParentOrganization /PrimaryAddress

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { DomesticUltimateOrganization { DUNSNumber string, up to 15 chars Pattern: {([0-9a-zA-Z]*)}, Optional [C] [M]

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

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { DomesticUltimateOrganization { OrganizationPrimaryName { OrganizationName string, up to 256 chars, Required [C] [M]

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

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { DomesticUltimateOrganization { PrimaryAddress { StreetAddressLine { LineText string, up to 240 chars, Required [C] [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 /Linkage /DomesticUltimateOrganization /PrimaryAddress

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { DomesticUltimateOrganization { PrimaryAddress { PrimaryTownName string, up to 64 chars, Optional [C] [M+]

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

Monitor Path: //Organization /Linkage /DomesticUltimateOrganization /PrimaryAddress

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { DomesticUltimateOrganization { PrimaryAddress { TerritoryName string, up to 128 chars, Optional

The name of the locally governed area which forms part of a centrally governed nation as received by D&B. Clarification Note: As a guiding principle this is a geographic area which could theoretically exist as a separate nation. In the U.S. this would be a State. In the UK this would be one of the Home Nations.

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { DomesticUltimateOrganization { PrimaryAddress { TerritoryAbbreviatedName string, up to 64 chars, Optional [C] [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 /Linkage /DomesticUltimateOrganization /PrimaryAddress

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { DomesticUltimateOrganization { PrimaryAddress { PostalCode string, up to 16 chars, Optional [C] [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 /Linkage /DomesticUltimateOrganization /PrimaryAddress

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { DomesticUltimateOrganization { PrimaryAddress { PrimaryTownWorldBaseCode integer, up to 32 digits, Optional [C] [M+]

Monitor Path: //Organization /Linkage /DomesticUltimateOrganization /PrimaryAddress

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { DomesticUltimateOrganization { PrimaryAddress { CountryWorldBaseCode integer, up to 3 digits, Optional [C] [M+]

The D&B three digit WorldBase code value that identifies country where the business is located.

Monitor Path: //Organization /Linkage /DomesticUltimateOrganization /PrimaryAddress

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { HeadquartersOrganization { DUNSNumber string, up to 15 chars Pattern: {([0-9a-zA-Z]*)}, Optional [C] [M]

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

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { HeadquartersOrganization { OrganizationPrimaryName { OrganizationName string, up to 256 chars, Required [C] [M]

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

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { HeadquartersOrganization { PrimaryAddress { StreetAddressLine { LineText string, up to 240 chars, Required [C] [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 /Linkage /HeadquartersOrganization /PrimaryAddress

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { HeadquartersOrganization { PrimaryAddress { PrimaryTownName string, up to 64 chars, Optional [C] [M+]

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

Monitor Path: //Organization /Linkage /HeadquartersOrganization /PrimaryAddress

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { HeadquartersOrganization { PrimaryAddress { CountryISOAlpha2Code string, at least 2 chars, up to 2 chars, Optional [C] [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 /Linkage /HeadquartersOrganization /PrimaryAddress

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { HeadquartersOrganization { PrimaryAddress { TerritoryName string, up to 128 chars, Optional [C] [M+]

The name of the locally governed area which forms part of a centrally governed nation as received by D&B. Clarification Note: As a guiding principle this is a geographic area which could theoretically exist as a separate nation. In the U.S. this would be a State. In the UK this would be one of the Home Nations.

Monitor Path: //Organization /Linkage /HeadquartersOrganization /PrimaryAddress

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { HeadquartersOrganization { PrimaryAddress { TerritoryAbbreviatedName string, up to 64 chars, Optional [C] [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 /Linkage /HeadquartersOrganization /PrimaryAddress

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { HeadquartersOrganization { PrimaryAddress { PostalCode string, up to 16 chars, Optional [C] [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 /Linkage /HeadquartersOrganization /PrimaryAddress

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { HeadquartersOrganization { PrimaryAddress { CountryOfficialName string, up to 64 chars, Optional [C] [M+]

Monitor Path: //Organization /Linkage /HeadquartersOrganization /PrimaryAddress

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { HeadquartersOrganization { PrimaryAddress { PrimaryTownWorldBaseCode integer, up to 32 digits, Optional [C] [M+]

Monitor Path: //Organization /Linkage /HeadquartersOrganization /PrimaryAddress

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { HeadquartersOrganization { PrimaryAddress { CountryWorldBaseCode integer, up to 3 digits, Optional [C] [M+]

The D&B three digit WorldBase code value that identifies country where the business is located.

Monitor Path: //Organization /Linkage /HeadquartersOrganization /PrimaryAddress

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { HeadquartersOrganization { PrimaryAddress { CountryGroupName string, up to 64 chars, Optional [C] [M+]

Monitor Path: //Organization /Linkage /HeadquartersOrganization /PrimaryAddress

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { HeadquartersOrganization { PrimaryAddress { CountyWorldbaseCode integer, up to 32 digits, Optional [C] [M]
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { DUNSNumber string, up to 15 chars Pattern: {([0-9a-zA-Z]*)}, Optional [C] [M]

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

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { OrganizationPrimaryName { OrganizationName string, up to 256 chars, Required [C] [M]

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

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { PrimaryAddress { StreetAddressLine { LineText string, up to 240 chars, Required [C] [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 /Linkage /ParentOrganization /PrimaryAddress

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { PrimaryAddress { PrimaryTownName string, up to 64 chars, Optional [C] [M+]

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

Monitor Path: //Organization /Linkage /ParentOrganization /PrimaryAddress

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { PrimaryAddress { TerritoryName string, up to 128 chars, Optional [C] [M+]

The name of the locally governed area which forms part of a centrally governed nation as received by D&B. Clarification Note: As a guiding principle this is a geographic area which could theoretically exist as a separate nation. In the U.S. this would be a State. In the UK this would be one of the Home Nations.

Monitor Path: //Organization /Linkage /ParentOrganization /PrimaryAddress

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { PrimaryAddress { TerritoryAbbreviatedName string, up to 64 chars, Optional [C] [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 /Linkage /ParentOrganization /PrimaryAddress

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { PrimaryAddress { PostalCode string, up to 16 chars, Optional [C] [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 /Linkage /ParentOrganization /PrimaryAddress

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { PrimaryAddress { CountryOfficialName string, up to 64 chars, Optional [C] [M+]

Monitor Path: //Organization /Linkage /ParentOrganization /PrimaryAddress

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { PrimaryAddress { PrimaryTownWorldBaseCode integer, up to 32 digits, Optional [C] [M+]

Monitor Path: //Organization /Linkage /ParentOrganization /PrimaryAddress

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { PrimaryAddress { CountryWorldBaseCode integer, up to 3 digits, Optional [C] [M+]

The D&B three digit WorldBase code value that identifies country where the business is located.

Monitor Path: //Organization /Linkage /GlobalUltimateOrganization /PrimaryAddress

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { PrimaryAddress { CountryGroupName string, up to 64 chars, Optional [C] [M+]

Monitor Path: //Organization /Linkage /ParentOrganization /PrimaryAddress

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { ParentOrganization { PrimaryAddress { CountyWorldbaseCode integer, up to 32 digits, Optional [C] [M]
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { FamilyTreeHierarchyLevel integer, up to 2 digits, Optional [C] [M]

A two-position code, in conjunction with the status and subsidiary indicators that pinpoints the location of an establishment within a corporate hierarchy.

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { LinkageUpdateDate Element
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { LinkageUpdateDate @DatePrecisionText Attribute
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { LinkageUpdateDate @DatePrecisionDNBCodeValue Attribute
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Linkage { LinkageUpdateDate @DatePrecisionDNBCodeTableNumber Attribute
OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { MostSeniorPrincipal { PrincipalName { FullName string, up to 256 chars, Optional [C] [M+]

Monitor Path: //Organization /PrincipalsAndManagement /MostSeniorPrincipal

OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { MostSeniorPrincipal { JobTitle { JobTitleText string, up to 3000 chars, Optional [C] [M+]

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

Monitor Path: //Organization /PrincipalsAndManagement /MostSeniorPrincipal

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

Currency Codes/Units

Whenever financial statement data is included in a response, each individual business element (ItemAmount) should be inspected for currency code and unit values (CurrencyISOAlpha3Code and UnitOfSize). If a given element does not include these attributes, the values provided in the statement header should be utilized.

For Customers using Optimizer (optional)

D&B Optimizer provides bulk WB1784 data; however, in a different format. A WB1784 product data reference guide is available to help customers understand how to transform and/or consume the Optimizer data in combination with the API response from this data layer.

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.

Name Description
Agent Indicator When 'true' indicates that the subject acts as an agent promoting the goods or services of another organization, e.g., Sales Agent, Purchasing Agent. [M]

PCM XPath: //Organization/ ActivitiesAndOperations/ SubjectIsAgentDetails/ AgentIndicator

Business Legal Structure Text that describes the legal form or structure of a business, as registered with government authorities, e.g., partnership, corporation, private limited company, government department, proprietorship. [M+]

PCM XPath: //Organization/ RegisteredDetail/ LegalFormDetails/ LegalFormText

Continent Code (World Region ID) Text recording the name of the region as defined by D&B for this address i.e., Africa, Australia/Asia, Europe, Middle East, South & Central America, North America. [M+]

PCM XPath: //Organization/ Location/ PrimaryAddress/ CountryGroupName

Control Year The year current control was assumed. [M]

PCM XPath: //Organization/ OrganizationDetail/ ControlOwnershipDate

Country Name Text recording the name of the country in which the business is located. [M+]

PCM XPath: //Organization/ Location/ PrimaryAddress/ CountryOfficialName

D&B City Code D&B proprietary geographical code which indicates the city where the business is located. For US records, the code is unique within COUNTY, for non-US records, the code is unique within COUNTRY. [M+]

PCM XPath: //Organization/ Location/ PrimaryAddress/ PrimaryTownWorldBaseCode

D&B Country Code D&B three-digit code which indicates the country where the business is located.

PCM XPath: //Organization/ Location/ PrimaryAddress/ CountryWorldBaseCode

D&B County Code D&B geographical code which identifies the county where the business is located. Code is unique within state/province.

PCM XPath: //Organization/ Location/ PrimaryAddress/ CountyWorldBaseCode

D&B Hoovers Industry Code An alphanumeric industry code identifying a business activity, based on a three-tier taxonomy developed by D&B as a complement to NAICS and SIC codes, that are assigned according to companies’ primary and secondary business activities.

PCM XPath: //Organization/ IndustryCode/ IndustryCode/ IndustryCode

D&B Hoovers Industry Code Description Text that describes the business activity based on the scheme specified by the attribute type.

PCM XPath: //Organization/ IndustryCode/ IndustryCode/ IndustryCodeDescription

D&B Mailing City Code D&B geographical code which indicates the city where the business is located for mailing address. For US records, the code is unique within COUNTY, for non-US records, the code is unique within COUNTRY. [M+]

PCM XPath: //Organization/ Location/ MailingAddress/ PrimaryTownWorldBaseCode

D&B Mailing Country Code D&B three-digit country code which indicates the country where the mailing address of the business is located.

PCM XPath: //Organization/ Location/ MailingAddress/ CountryWorldBaseCode

D&B Mailing County Code D&B geographical code which indicates the county where the business is located for mailing address. Populated in US and Canada only; unique within state/province. Zeros if not available.

PCM XPath: //Organization/ Location/ MailingAddress/ CountyWorldBaseCode

D&B Mailing Region/Continent Code D&B code which indicates the region of the mailing address of the business. [M+]

PCM XPath: //Organization/ Location/ MailingAddress/ CountryGroupName

D&B Mailing State/Province Code D&B geographical code which indicates the state/province where the business is located for mailing address. Only validated state/province names carry a state/province code. [M+]

PCM XPath: //Organization/ Location/ MailingAddress/ TerritoryWorldBaseCode

D&B Standard Industry Code An alphanumeric value identifying a business activity based on the scheme specified by the Standard Industrial Classification (SIC) Code. The first four digits are external codes created by the U.S. Government. D&B has created extensions to more precisely define an activity as in the case of the SIC 2+2 (the last 4 digits of an 8-digit SIC).

PCM XPath: //Organization/ IndustryCode/ IndustryCode/ IndustryCode

D&B Standard Industry Code Description Text that describes the business activity based on the scheme specified by the attribute type, e.g., 'highway and street construction' is the description of industry code 1611 in the U.S. SIC (Standard Industrial Classification) system.

PCM XPath: //Organization/ IndustryCode/ IndustryCode/ IndustryCodeDescription

D&B State/Province Code D&B geographical code which indicates the state/province (aka primary subdivision) where the business is located. Only validated state/province names carry a state/province code. [M+]

PCM XPath: //Organization/ Location/ PrimaryAddress/ TerritoryWorldBaseCode

Domestic Ultimate Business Name Text recording the name of the highest business in the family tree that is in the same country as the subject. [M]

PCM XPath: //Organization/ Linkage/ DomesticUltimateOrganization/ OrganizationPrimaryName/ OrganizationName

Domestic Ultimate D&B City Code D&B code of the city where the domestic ultimate is located. [M+]

PCM XPath: //Organization/ Linkage/ DomesticUltimateOrganization/ PrimaryAddress/ PrimaryTownWorldBaseCode

Domestic Ultimate D&B Country Code D&B code of the country where the domestic ultimate is located. [M+]

PCM XPath: //Organization/ Linkage/ DomesticUltimateOrganization/ PrimaryAddress/ CountryWorldBaseCode

Domestic Ultimate D-U-N-S Number The D-U-N-S Number of the highest level parent within a corporate family tree that is domiciled in the same country as the requested company. A parent is a corporation that owns more than 50% of another corporation's capital stock. A subject may be its own domestic ultimate. [M]

PCM XPath: //Organization/ Linkage/ DomesticUltimateOrganization/ DUNSNumber

Domestic Ultimate Postal Code An identifier used by the local country postal authority to identify where the domestic ultimate is located. [M+]

PCM XPath: //Organization/ Linkage/ DomesticUltimateOrganization/ PrimaryAddress/ PostalCode

Domestic Ultimate Street Address Text recording the address number and street name where the domestic ultimate is located. [M+]

PCM XPath: //Organization/ Linkage/ DomesticUltimateOrganization/ PrimaryAddress/ StreetAddressLine/ LineText

Domestic Ultimate 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 domestic ultimate is located. [M+]

PCM XPath: //Organization/ Linkage/ DomesticUltimateOrganization/ PrimaryAddress/ TerritoryAbbreviatedName

Domestic Ultimate Territory Name Text recording the name of a locally governed area which forms part of a centrally governed nation, i.e., state, province or territory, where the domestic ultimate is located.

PCM XPath: //Organization/ Linkage/ DomesticUltimateOrganization/ PrimaryAddress/ TerritoryName

Domestic Ultimate Town Name Text recording the name of the city, town, village, etc. where the domestic ultimate is located. [M+]

PCM XPath: //Organization/ Linkage/ DomesticUltimateOrganization/ PrimaryAddress/ PrimaryTownName

D-U-N-S Number Transfer Date The date associated with the most recent retirement of a D-U-N-S Number affecting this subject. When included in a monitoring notice, the Retained D-U-N-S Number should be used for subsequent requests. When included in a product response, the Previous D-U-N-S Number is provided for reference purposes.

PCM XPath: //Organization/ SubjectHeader/ TransferDUNSNumberRegistration/ TransferDate

D-U-N-S Number Transfer Reason Text Text explaining the most recent retirement of a D-U-N-S Number affecting this subject. When included in a monitoring notice, the Retained D-U-N-S Number should be used for subsequent requests. When included in a product response, the Previous D-U-N-S Number is provided for reference purposes.

PCM XPath: //Organization/ SubjectHeader/ TransferDUNSNumberRegistration/ TransferReasonText

Employee Quantity (All Locations) A number that defines how many people are directly engaged and paid by the organization to perform or support its business operations. [M]

PCM XPath: //Organization/ EmployeeFigures/ ConsolidatedEmployeeDetails/ TotalEmployeeQuantity

Employee Quantity (Single Location) A number that defines how many people are directly engaged and paid by the organization to perform or support its business operations at the subject's location. [M]

PCM XPath: //Organization/ EmployeeFigures/ IndividualEntityEmployeeDetails/ TotalEmployeeQuantity

Employee Quantity Basis Text Text that indicates when it has been reported to D&B that certain types of employees have been included in the calculation of the Employee Quantity. [M+]

PCM XPath: //Organization/ EmployeeFigures/ ConsolidatedEmployeeDetails/ EmployeeCategoryDetails/ EmployeeBasisText

Employee Quantity Reliability Text (All Locations) Text that describes the integrity of the employee figures, e.g., actual, estimated, or modeled. [M+]

PCM XPath: //Organization/ EmployeeFigures/ ConsolidatedEmployeeDetails/ ReliabilityText

Employee Quantity Reliability Text (Single Location) Text that describes the integrity of the employee figures, e.g., actual, estimated, or modeled. [M+]

PCM XPath: //Organization/ EmployeeFigures/ IndividualEntityEmployeeDetails/ ReliabilityText

Export Indicator When 'true' indicates that the subject business exports goods to other countries. [M]

PCM XPath: //Organization/ ActivitiesAndOperations/ ExportDetails/ ExportIndicator

Family Tree Hierarchy Level Code A two-position counter that indicates the number of family tree levels below the global ultimate business in its corporate hierarchy. The hierarchy level value of the global ultimate will always be 1. Each subsidiary level below the global ultimate is incremented by one. Branch locations in a family tree will have the same hierarchy code as its associated headquarter. [M]

PCM XPath: //Organization/ Linkage/ FamilyTreeHierarchyLevel

FEIN Tax ID Number A number recording a unique nine-digit FEIN number assigned by the U.S. Internal Revenue Service to business entities (and in some cases individuals) operating in the United States for the purposes of identification.

PCM XPath: //Organization/ RegisteredDetail/ OrganizationIdentificationNumberDetail/ OrganizationIdentificationNumber

Full Report Date The date when a complete review of all Business Information Report data was updated about the business.

PCM XPath: //Organization/ SubjectHeader/ FullReportDate

Global Ultimate Business Name Text recording the primary name of the global ultimate business. [M]

PCM XPath: //Organization/ Linkage/ GlobalUltimateOrganization/ OrganizationPrimaryName/ OrganizationName

Global Ultimate Country Name Name of the country where the global ultimate is located. [M+]

PCM XPath: //Organization/ Linkage/ GlobalUltimateOrganization/ PrimaryAddress/ CountryOfficialName

Global Ultimate D&B City Code D&B code of the city where the global ultimate is located. [M+]

PCM XPath: //Organization/ Linkage/ GlobalUltimateOrganization/ PrimaryAddress/ PrimaryTownWorldBaseCode

Global Ultimate D&B Country Code D&B code of the country where the global ultimate is located. [M+]

PCM XPath: //Organization/ Linkage/ GlobalUltimateOrganization/ PrimaryAddress/ CountryWorldBaseCode

Global Ultimate D&B County Code D&B geographical code which identifies the county where the global ultimate is located. Code is unique within state/province. [M+]

PCM XPath: //Organization/ Linkage/ GlobalUltimateOrganization/ PrimaryAddress/ CountyWorldBaseCode

Global Ultimate D&B Region/Continent Code D&B code for the region where the global ultimate is located. [M+]

PCM XPath: //Organization/ Linkage/ GlobalUltimateOrganization/ PrimaryAddress/ CountryGroupName

Global Ultimate D-U-N-S Number The D-U-N-S number of the highest level parent within a corporate family tree. A parent is a corporation that owns more than 50% of another corporation's capital stock. A subject may be its own global ultimate. [M]

PCM XPath: //Organization/ Linkage/ GlobalUltimateOrganization/ DUNSNumber

Global Ultimate Postal Code An identifier used by the local country postal authority to identify where the global ultimate is located. [M+]

PCM XPath: //Organization/ Linkage/ GlobalUltimateOrganization/ PrimaryAddress/ PostalCode

Global Ultimate Street Address Text recording the address number, or post office box number and street name where the global ultimate is located. [M+]

PCM XPath: //Organization/ Linkage/ GlobalUltimateOrganization/ PrimaryAddress/ StreetAddressLine/ LineText

Global Ultimate 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 global ultimate is located. [M+]

PCM XPath: //Organization/ Linkage/ GlobalUltimateOrganization/ PrimaryAddress/ TerritoryAbbreviatedName

Global Ultimate Territory Name Text recording the name of a locally governed area which forms part of a centrally governed nation, i.e., state, province or territory, where the global ultimate is located. [M+]

PCM XPath: //Organization/ Linkage/ GlobalUltimateOrganization/ PrimaryAddress/ TerritoryOfficialName

Note: PCM XPath: //Organization/ Linkage/ GlobalUltimateOrganization/ PrimaryAddress/ TerritoryName will continue to be delivered; however, the XPath including TerritoryOfficialName should be used.

Global Ultimate Town Name Text recording the name of the city, town, village, etc. where the global ultimate is located. [M+]

PCM XPath: //Organization/ Linkage/ GlobalUltimateOrganization/ PrimaryAddress/ PrimaryTownName

Headquarters Business Name The business name of the headquarters company. A headquarters is a business establishment that has branches or divisions reporting to it. [M]

PCM XPath: //Organization/ Linkage/ HeadquartersOrganization/ OrganizationPrimaryName/ OrganizationName

Headquarters Country Code The two-letter country code, defined by the International Organization for Standardization (ISO) standard ISO 3166-1 identifying the country of the company headquarters.

PCM XPath: //Organization/ Linkage/ HeadquartersOrganization/ PrimaryAddress/ CountryISOAlpha2Code

Headquarters Country Name Name of the country where the company headquarters is located. [M+]

PCM XPath: //Organization/ Linkage/ HeadquartersOrganization/ PrimaryAddress/ CountryOfficialName

Headquarters D&B City Code D&B code of the city where the headquarters is located. [M+]

PCM XPath: //Organization/ Linkage/ HeadquartersOrganization/ PrimaryAddress/ PrimaryTownWorldBaseCode

Headquarters D&B Country Code D&B code of the country where the company headquarters is located.

PCM XPath: //Organization/ Linkage/ HeadquartersOrganization/ PrimaryAddress/ CountryWorldBaseCode

Headquarters D&B County Code D&B geographical code which identifies the county where the headquarters is located. Code is unique within state/province.

PCM XPath: //Organization/ Linkage/ HeadquartersOrganization/ PrimaryAddress/ CountyWorldbaseCode

Headquarters D&B Region/Continent Code D&B code for the region where the headquarters is located. [M+]

PCM XPath: //Organization/ Linkage/ HeadquartersOrganization/ PrimaryAddress/ CountryGroupName

Headquarters D-U-N-S Number The D-U-N-S Number of the headquarters company. A headquarters is a business establishment that has branches or divisions reporting to it. [M]

PCM XPath: //Organization/ Linkage/ HeadquartersOrganization/ DUNSNumber

Headquarters Postal Code An identifier used by the local country postal authority to identify where the headquarters is located. [M+]

PCM XPath: //Organization/ Linkage/ HeadquartersOrganization/ PrimaryAddress/ PostalCode

Headquarters Street Address Text recording the address number, or post office box number and street name where the headquarters is located. [M+]

PCM XPath: //Organization/ Linkage/ HeadquartersOrganization/ PrimaryAddress/ StreetAddressLine/ LineText

Headquarters 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 headquarters is located. [M+]

PCM XPath: //Organization/ Linkage/ HeadquartersOrganization/ PrimaryAddress/ TerritoryAbbreviatedName

Headquarters Territory Name Text recording the name of a locally governed area which forms part of a centrally governed nation, i.e., state, province or territory, where the headquarters is located. [M+]

PCM XPath: //Organization/ Linkage/ HeadquartersOrganization/ PrimaryAddress/ TerritoryName

Headquarters Town Name Text recording the name of the city, town, village, etc. where the headquarters is located. [M+]

PCM XPath: //Organization/ Linkage/ HeadquartersOrganization/ PrimaryAddress/ PrimaryTownName

Import Indicator When 'true' indicates that the subject business imports a quantity of goods from other countries. [M]

PCM XPath: //Organization/ ActivitiesAndOperations/ ImportDetails/ ImportIndicator

Last Update Date The date when the record was last updated in D&B's system.

PCM XPath: //Organization/ SubjectHeader/ LastUpdateDate

Line of Business Text recording the description of the operations conducted by a business. [M+]

PCM XPath: //Organization/ ActivitiesAndOperations/ LineOfBusinessDetails/ LineOfBusinessDescription

Linkage Update Date The date when a review of the entire family tree was completed to verify linkage relationships within the family was updated.

PCM XPath: //Organization/ Linkage/ LinkageUpdateDate

Local Activity Industry Code Records the business activities in which an organization is actively engaged using standardized coding schemes such as European NACE and other country-specific Classification of Economic Activities.

PCM XPath: //Organization/ IndustryCode/ IndustryCode/ IndustryCode

Mailing Country Name Text recording the name of the country which the business uses for mailing purposes. [M+]

PCM XPath: //Organization/ Location/ MailingAddress/ CountryOfficialName

Most Senior Principal Full Name Text recording the name of the CEO. [M+]

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

Most Senior Principal Job Title Text recording the job held by the most senior principal; For example, CEO, President and CEO. [M+]

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

NAICS Code An alphanumeric value identifying the business activity based on the North American Industry Classification System (NAICS) 2017 Code (Industry Type Code: 700). Can repeat multiple times. [C]

PCM XPath: //Organization/ IndustryCode/ IndustryCode/ IndustryCode

NAICS Code Description Text that describes the business activity specified by the North American Industry Classification System (NAICS) 2017 Code (Industry Type Code: 700), e.g., "General Freight Trucking, Long-Distance, Less Than Truckload" is the description of NAICS code 484122. [C]

PCM XPath: //Organization/ IndustryCode/ IndustryCode/ IndustryCodeDescription

Number of Family Members Including Subsidiaries The number of linkages in the upward and downward directions of the entire corporate family tree that the subject belongs to, starting from the global ultimate. [M]

PCM XPath: //Organization/ Linkage/ LinkageSummary/ GlobalUltimateFamilyTreeLinkageCount

Parent Business Name Text recording the business name of the parent company. A parent is a corporation that owns more than 50% of another corporation's capital stock; these owned companies are subsidiaries to the parent company. [M]

PCM XPath: //Organization/ Linkage/ ParentOrganization/ OrganizationPrimaryName/ OrganizationName

Parent Country Name Name of the country where the parent organization is located. [M+]

PCM XPath: //Organization/ Linkage/ ParentOrganization/ PrimaryAddress/ CountryOfficialName

Parent D&B City Code D&B code of the city where the parent organization is located. [M+]

PCM XPath: //Organization/ Linkage/ ParentOrganization/ PrimaryAddress/ PrimaryTownWorldBaseCode

Parent D&B Country Code D&B code of the country where the parent organization is located.

PCM XPath: //Organization/ Linkage/ ParentOrganization/ PrimaryAddress/ CountryWorldBaseCode

Parent D&B County Code D&B geographical code which identifies the county where the parent organization is located. Code is unique within state/province.

PCM XPath: //Organization/ Linkage/ ParentOrganization/ PrimaryAddress/ CountyWorldbaseCode

Parent D&B Region/Continent Code D&B code for the region where the parent organization is located. [M+]

PCM XPath: //Organization/ Linkage/ ParentOrganization/ PrimaryAddress/ CountryGroupName

Parent D-U-N-S Number The D-U-N-S number of the parent company. A parent is a corporation that owns more than 50% of another corporation's capital stock; these owned companies are subsidiaries to the parent company.   [M]

PCM XPath: //Organization/ Linkage/ ParentOrganization/ DUNSNumber

Parent Postal Code An identifier used by the local country postal authority to identify where the parent company is located. [M+]

PCM XPath: //Organization/ Linkage/ ParentOrganization/ PrimaryAddress/ PostalCode

Parent Street Address Text recording the address number, or post office box number and street name where the parent company is located. [M+]

PCM XPath: //Organization/ Linkage/ ParentOrganization/ PrimaryAddress/ StreetAddressLine/ LineText

Parent 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 parent company is located. [M+]

PCM XPath: //Organization/ Linkage/ ParentOrganization/ PrimaryAddress/ TerritoryAbbreviatedName

Parent Territory Name Text recording the name of a locally governed area which forms part of a centrally governed nation, i.e., state, province or territory, where the parent company is located. [M+]

PCM XPath: //Organization/ Linkage/ ParentOrganization/ PrimaryAddress/ TerritoryName

Parent Town Name Text recording the name of the city, town, village, etc. where the parent company is located. [M+]

PCM XPath: //Organization/ Linkage/ ParentOrganization/ PrimaryAddress/ PrimaryTownName

Previous D-U-N-S Number (Transfer) The most recently retired D-U-N-S Number that is associated with this subject, often as a redundant record. An explanation for this change is provided in the transfer reason. [M+]

PCM XPath: //Organization/ SubjectHeader/ TransferDUNSNumberRegistration/ TransferredFromDUNSNumber

Primary SIC Code The first listed alphanumeric value identifying the primary business activity based on the scheme specified by the Standard Industrial Classification (SIC) Code. The first four digits are external codes created by the U.S. Government. D&B has created extensions to more precisely define an activity as in the case of the SIC 2+2 (the last 4 digits of an 8-digit SIC).

PCM XPath: //Organization/ IndustryCode/ IndustryCode/ IndustryCode

Primary SIC Description Text that describes the business activity based on the scheme specified by the attribute type, e.g., 'highway and street construction' is the description of industry code 1611 in the U.S. SIC (Standard Industrial Classification) system.

PCM XPath: //Organization/ IndustryCode/ IndustryCode/ IndustryCodeDescription

Registered Address Indicator When 'true' indicates that the Primary Address which has been presented is also the Registered Address. [M+]

PCM XPath: //Organization/ Location/ PrimaryAddress/ RegisteredAddressIndicator

Registration Identification Number A registration or identification number assigned by local government agencies to identify a business within the local market. Examples include the France Siret Number, European VAT Number, Australian Business Number, Brazilian State Registry Number.

PCM XPath: //Organization/ RegisteredDetail/ OrganizationIdentificationNumberDetail/ OrganizationIdentificationNumber

Registration Number - All Countries Except US A registration or identification number assigned by local government agencies to identify a business within the local market. Examples include the France Siret Number, European Union VAT Number, Australian Business Number, Brazilian State Registry Number.

PCM XPath: //Organization/ RegisteredDetail/ OrganizationIdentificationNumberDetail/ OrganizationIdentificationNumber

Retained D-U-N-S Number (Transfer) In the event that the D-U-N-S Number of this subject is retired, this field will contain the D-U-N-S Number to reference for future product requests. An explanation for this change is provided in the transfer reason.

PCM XPath: //Organization/ SubjectHeader/ TransferDUNSNumberRegistration/ TransferredToDUNSNumber

Sales Revenue Amount in Local Currency (Key Financials) The monetary value of income received from customers from the sale of the business' goods and/or services. This is the gross sales minus any returns, rebates/discounts, allowances for damages or shortages, shipping expenses passed on to the customer. [M]

PCM XPath: //Organization/ Financial/ KeyFinancialFiguresOverview/ SalesRevenueAmount

Sales Revenue Amount in US Dollars (Key Financials) The revenue claimed in the income statement data in millions (USD). [M]

PCM XPath: //Organization/ Financial/ KeyFinancialFiguresOverview/ SalesRevenueAmount

Secondary SIC Code An alphanumeric value identifying a business activity based on the scheme specified by the Standard Industrial Classification (SIC) Code. Clarification Note: These are generally external codes created by an external authoritative body like the U.S. Office of Management and Budget but D&B may have created extensions to more precisely define an activity as in the case of the SIC 2+2 (the last 4 digits of an 8-digit SIC). Can repeat up to five times.

PCM XPath: //Organization/ IndustryCode/ IndustryCode/ IndustryCode

Secondary SIC Description Text that describes the business activity based on the scheme specified by the attribute type, e.g., 'highway and street construction' is the description of industry code 1611 in the U.S. SIC (Standard Industrial Classification) system.

PCM XPath: //Organization/ IndustryCode/ IndustryCode/ IndustryCodeDescription

UK SIC Code The first listed alphanumeric value identifying the primary business activity based on the UK SIC Code.

PCM XPath: //Organization/ IndustryCode/ IndustryCode/ IndustryCode

UNSPSC Code An alphanumeric value identifying a product or service based on the United Nations Standard Products and Services Code (UNSPSC). UNSPSC is a four-level hierarchical convention that is coded as an eight-digit number, with an optional fifth level adding two more digits.

PCM XPath: //Organization/ IndustryCode/ IndustryCode/ IndustryCode

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 availability of certain scores delivered by this product may be limited due to a lack of sufficient company or industry specific data to perform the calculations.

Compatibility with Batch File products

The following fields are included in this data layer for existing D&B customers who may have internal systems and/or processes that rely upon these codes:

  • Location.PrimaryAddress.PrimaryTownWorldBaseCode
  • Location.PrimaryAddress.TerritoryWorldBaseCode
  • Location.PrimaryAddress.CountryWorldBaseCode
  • Location.PrimaryAddress.CountyWorldBaseCode
  • Location.MailingAddress.PrimaryTownWorldBaseCode
  • Location.MailingAddress.TerritoryWorldBaseCode
  • Location.MailingAddress.CountryWorldBaseCode
  • Location.MailingAddress.CountyWorldBaseCode
  • Linkage.GlobalUltimateOrganization.PrimaryAddress.PrimaryTownWorldBaseCode
  • Linkage.GlobalUltimateOrganization.PrimaryAddress.CountryWorldBaseCode
  • Linkage.GlobalUltimateOrganization.PrimaryAddress.CountyWorldBaseCode
  • Linkage.DomesticUltimateOrganization.PrimaryAddress.PrimaryTownWorldBaseCode
  • Linkage.DomesticUltimateOrganization.PrimaryAddress.CountryWorldBaseCode
  • Linkage.HeadquartersOrganization.PrimaryAddress.PrimaryTownWorldBaseCode
  • Linkage.HeadquartersOrganization.PrimaryAddress.CountryWorldBaseCode
  • Linkage.HeadquartersOrganization.PrimaryAddress.CountyWorldbaseCode
  • Linkage.ParentOrganization.PrimaryAddress.PrimaryTownWorldBaseCode
  • Linkage.ParentOrganization.PrimaryAddress.CountryWorldBaseCode
  • Linkage.ParentOrganization.PrimaryAddress.CountyWorldbaseCode

New implementations should be developed using the corresponding fields that are based on coding standards for geographic locations. For example, instead of CountryWorldBaseCode, please use CountryISOAlpha2Code.

A conversion table for WorldBase to ISO codes is available on the Country Chart tab (far right column contains the WorldBase codes) of the downloadable Data Primer.