Loading

Direct 2.0
Collapse

Predictive Bankruptcy Risk - D&B Financial Stress Score (FSS)

Product(s)D&B Direct 2.0
Product Code(s)PBR_FSS_V7.1
Level(s)Standard
Monitoring AvailableYes
InterfaceREST
MethodGET
Format(s)JSON
ServiceAssessment
{version}5.0
5.0 Released OnJanuary 23, 2015

The US Financial Stress Score (FSS) predicts the likelihood that a business will go bankrupt or close with outstanding debts within the next twelve months. Contrasted with previous releases, Version 7.1 utilizes more financial statement and ratio variables, to better predict impending financial distress.

This product is also known as the D&B Failure Score.

See the Predictive Analytics page for more information on Dun & Bradstreet's risk scores.

Update History

  • April 17, 2015 (v5.0 + earlier SOAP & REST): The OrganizationDetail.OperatingStatusText field (equal to 403) should be used in place of OrganizationDetail.OutofBusinessIndicator. 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 December 14, 2018.

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 a country code of "US".

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

Global Availability

This data layer is only available for businesses domiciled in the United States.

NOTE: The FSS score is available for additional countries as part of the Predictive Bankruptcy & Payment Risk data layer.

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 "Predictive Bankruptcy Risk - D&B Financial Stress Score (FSS) 2006/2007/2010" 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 (PBR_FSS_V7.1)
GET https://direct.dnb.com/V5.0/organizations/804735132/products/PBR_FSS_V7.1
Authorization: <My Token>

Previous Calculations

Existing D&B customers who have developed applications that rely on an earlier Financial Stress Score (FSS) calculation may request either the v 6.0 or v 5.0 variation of the FSS by passing the alternate product codes of PBR_FSS_V6.0 or PBR_FSS_V5.0 respectively.

Name Characteristics
{version} Element
ApplicationTransactionID string, up to 64 chars, Optional

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

TransactionTimestamp DateTimestamp, Optional

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

SubmittingOfficeID string, up to 64 chars, Optional

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

{DUNS} string, up to 15 chars Pattern: {([0-9a-zA-Z]*)}, Required

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

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

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

Possible values: true; false

ExtendArchivePeriodIndicator boolean, Optional

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

Possible values: true; false

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

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

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

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

Endpoint

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

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

REST (Assessment)
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)

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 (PBR_FSS_V7.1)
{"OrderProductResponse": {
  "@ServiceVersionNumber": "5.0",
  "TransactionDetail":   {
    "ServiceTransactionID": "Id-289ba47a52d58aab0acb730e-2",
    "TransactionTimestamp": "2014-01-14T14:06:20.409-05:00"
  },
  "TransactionResult":   {
    "SeverityText": "Information",
    "ResultID": "CM000",
    "ResultText": "Success"
  },
  "OrderProductResponseDetail":   {
    "InquiryDetail":     {
      "DUNSNumber": "804735132",
      "CountryISOAlpha2Code": "US"
    },
    "Product":     {
      "DNBProductID": "PBR_FSS_V7.1",
      "Organization":       {
        "SubjectHeader": {"DUNSNumber": "804735132"},
        "Telecommunication": {"TelephoneNumber": [        {
          "TelecommunicationNumber": "(650) 555-0000",
          "InternationalDialingCode": "1"
        }]},
        "Location": {"PrimaryAddress": [        {
          "StreetAddressLine": [{"LineText": "492 Koller St"}],
          "PrimaryTownName": "San Francisco",
          "CountryISOAlpha2Code": "US",
          "TerritoryAbbreviatedName": "CA",
          "PostalCode": "94110",
          "TerritoryOfficialName": "California"
        }]},
        "Financial": {"FinancialStatement": [        {
          "StatementHeaderDetails":           {
            "FinancialStatementToDate": {"$": "2012-12-31"},
            "CurrencyISOAlpha3Code": "USD",
            "UnitOfSizeText": {"$": "SingleUnits"}
          },
          "BalanceSheet": {"Liabilities": {"TotalEquityAmount":           {
            "@DNBCodeValue": 3047,
            "$": 1180200
          }}}
        }]},
        "OrganizationName":         {
          "OrganizationPrimaryName": [{"OrganizationName": {"$": "Gorman Manufacturing Company, Inc."}}],
          "DoNotConfuseOrganizationName": [          {
            "OrganizationName": {"$": "other Gorman companies, this is a fictitious company used by D&B for demonstration purposes"},
            "DisplaySequence": 1
          }]
        },
        "OrganizationDetail":         {
          "FamilyTreeMemberRole":           [
            {"FamilyTreeMemberRoleText":             {
              "@DNBCodeValue": 12775,
              "$": "Global Ultimate"
            }},
            {"FamilyTreeMemberRoleText":             {
              "@DNBCodeValue": 12774,
              "$": "Domestic Ultimate"
            }},
            {"FamilyTreeMemberRoleText":             {
              "@DNBCodeValue": 12773,
              "$": "Parent"
            }}
          ],
          "ControlOwnershipDate": {"$": "1985"},
          "OrganizationStartYear": "1985"
        },
        "IndustryCode": {"IndustryCode": [        {
          "@DNBCodeValue": 399,
          "@TypeText": "US SIC (1987)",
          "IndustryCode": {"$": "27 52"},
          "DisplaySequence": 1
        }]},
        "ActivitiesAndOperations": {"LineOfBusinessDetails": [{"LineOfBusinessDescription":         {
          "@LanguageCode": 39,
          "$": "Lithographic commercial printing"
        }}]},
        "EmployeeFigures":         {
          "HeadquartersLocationEmployeeDetails": {"TotalEmployeeQuantity": 110},
          "ConsolidatedEmployeeDetails": {"TotalEmployeeQuantity": 125}
        },
        "Assessment":         {
          "DNBStandardRating": {"DNBStandardRating": "3A4"},
          "FinancialStressScore": [          {
            "RawScore": 1435,
            "ClassScore": "4",
            "NationalPercentile": 29,
            "RiskIncidencePercentage": 84,
            "RiskIncidenceCount": 84,
            "AverageNationalRiskIncidencePercentage": 48,
            "AverageNationalRiskIncidenceCount": 48,
            "ScoreCommentary":             [
              {"CommentaryText": {"$": "Composite credit appraisal is rated limited."}},
              {"CommentaryText": {"$": "High proportion of slow payment experiences to total number of payment experiences."}},
              {"CommentaryText": {"$": "Low proportion of satisfactory payment experiences to total payment experiences."}},
              {"CommentaryText": {"$": "UCC Filings reported."}},
              {"CommentaryText": {"$": "Unstable Paydex over last 12 months."}}
            ],
            "ScoreDate": {"$": "2014-01-14"}
          }],
          "FinancialStressReferenceData": {"RiskIncidence":           [
                        {
              "ClassScore": "1",
              "RiskIncidenceScoreableUniverseSubjectPercentage": 0,
              "RiskIncidenceRelativeToOverallRiskIncidencePercentage": 9400
            },
                        {
              "ClassScore": "2",
              "RiskIncidenceScoreableUniverseSubjectPercentage": 0,
              "RiskIncidenceRelativeToOverallRiskIncidencePercentage": 8100
            },
                        {
              "ClassScore": "3",
              "RiskIncidenceScoreableUniverseSubjectPercentage": 0,
              "RiskIncidenceRelativeToOverallRiskIncidencePercentage": 5000
            },
                        {
              "ClassScore": "4",
              "RiskIncidenceScoreableUniverseSubjectPercentage": 0,
              "RiskIncidenceRelativeToOverallRiskIncidencePercentage": 17500
            },
                        {
              "ClassScore": "5",
              "RiskIncidenceScoreableUniverseSubjectPercentage": 0,
              "RiskIncidenceRelativeToOverallRiskIncidencePercentage": 97900
            }
          ]},
          "AssessmentSummaryText":           [
            "23% of trade experiences indicate slow payment(s) are present.",
            "Payment experiences exist for this firm which are greater than 60 days past due.",
            "Payment information indicates negative payment comments.",
            "Control age or date entered in D&B files indicates lower risk.",
            "Evidence of open Lien(s) and Judgment(s) in the D&B database.",
            "Financial condition is FAIR or UNBALANCED.",
            "D&B files indicate a net worth for this firm of $1,180,200.",
            "Quick ratio is 0.7."
          ]
        },
        "PrincipalsAndManagement": {"MostSeniorPrincipal":         {
          "PrincipalName":           {
            "@type": "ass:IndividualNameType",
            "FullName": "Leslie Smith"
          },
          "Position": [{"PositionText": {"$": "Pres"}}]
        }}
      }
    }
  }
}}
Name Characteristics
OrderProductResponse Aggregate
OrderProductResponse @ServiceVersionNumber Attribute
OrderProductResponse { TransactionDetail Aggregate, string, up to 64 chars., Required

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

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

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

OrderProductResponse { TransactionDetail { ServiceTransactionID Element, Required

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

OrderProductResponse { TransactionDetail { TransactionTimestamp Element, Required

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

End: OrderProductResponse { TransactionDetail Aggregate
OrderProductResponse { TransactionResult Aggregate, string, up to 16 chars., Required

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

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

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

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

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

OrderProductResponse { TransactionResult { ResultText Element, Optional

Text that explains the outcome of the transaction.

OrderProductResponse { TransactionResult { ResultMessage Aggregate, string, up to 512 chars., Optional (Array)

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

OrderProductResponse { TransactionResult { ResultMessage { ResultDescription Element, Required

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

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

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

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

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

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

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

OrderProductResponse { OrderProductResponseDetail { InquiryDetail { CountryISOAlpha2Code Element, 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.

End: OrderProductResponse { OrderProductResponseDetail { InquiryDetail Aggregate
OrderProductResponse { OrderProductResponseDetail { Product Aggregate, string, up to 64 chars., Required

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

OrderProductResponse { OrderProductResponseDetail { Product { DNBProductID Element, integer, up to 7 digits., Optional

An alphanumeric string that uniquely identifies this product.

OrderProductResponse { OrderProductResponseDetail { Product { LanguageCode Element, 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, string, up to 15 chars. Pattern: {([0-9a-zA-Z]*)}., Required

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

OrderProductResponse { OrderProductResponseDetail { Product { Organization { SubjectHeader { DUNSNumber Element, Optional

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

End: OrderProductResponse { OrderProductResponseDetail { Product { Organization { SubjectHeader Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location Aggregate, Optional

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

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

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

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress { StreetAddressLine Aggregate, string, up to 240 chars., Optional (Array)

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

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress { StreetAddressLine { LineText Element, Required, [M+]

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

Monitor Path: //Organization /Location /PrimaryAddress

End: OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress { StreetAddressLine Aggregate, string, up to 64 chars.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress { PrimaryTownName Element, string, at least 2 chars. up to 2 chars., Optional, [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 { CountryISOAlpha2Code Element, string, up to 16 chars., Optional, [M+]

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

Monitor Path: //Organization /Location /PrimaryAddress

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

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

Monitor Path: //Organization /Location /PrimaryAddress

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

Monitor Path: //Organization /Location /PrimaryAddress

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { PrimaryAddress { TerritoryAbbreviatedName Element, Optional, [M+]

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

Monitor Path: //Organization /Location /PrimaryAddress

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

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

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { MailingAddress { StreetAddressLine Aggregate, string, up to 240 chars., Optional (Array)

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

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { MailingAddress { StreetAddressLine { LineText Element, Required, [M+]

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

Monitor Path: //Organization /Location /MailingAddress

End: OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { MailingAddress { StreetAddressLine Aggregate, string, up to 64 chars.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { MailingAddress { PrimaryTownName Element, string, at least 2 chars. up to 2 chars., Optional, [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 { CountryISOAlpha2Code Element, string, up to 64 chars., Optional, [M+]

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

Monitor Path: //Organization /Location /MailingAddress

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

Monitor Path: //Organization /Location /MailingAddress

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

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

Monitor Path: //Organization /Location /MailingAddress

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

Monitor Path: //Organization /Location /MailingAddress

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { MailingAddress { TerritoryAbbreviatedName Element, Optional, [M+]

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

Monitor Path: //Organization /Location /MailingAddress

End: OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location { MailingAddress Aggregate
End: OrderProductResponse { OrderProductResponseDetail { Product { Organization { Location Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Telecommunication Aggregate, Optional

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

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Telecommunication { TelephoneNumber Aggregate, string, at least 1 chars. up to 50 chars., Optional (Array)

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

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Telecommunication { TelephoneNumber { TelecommunicationNumber Element, string, up to 7 chars., Required, [M+]

A sequence of digits used by the subject for voice communication in a public switched telephone network. This sequence of digits includes the area code or city code.

NOTE: This number does not include the International Dialing Code and Domestic Dialing Code.

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

Monitor Path: //Organization /Telecommunication

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Telecommunication { TelephoneNumber { InternationalDialingCode Element, Optional, [M+]

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

Monitor Path: //Organization /Telecommunication

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

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

End: OrderProductResponse { OrderProductResponseDetail { Product { Organization { Telecommunication { FacsimileNumber Aggregate
End: OrderProductResponse { OrderProductResponseDetail { Product { Organization { Telecommunication Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events Aggregate, Optional

Records the information about events that have either involved or affected the subject (usually an organization, but sometimes an individual who is an owner or principal of an organization). It covers legal events, significant events and financing events.

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { PublicFilingHeader Aggregate, Optional

Records the information about Legal and Financing Events.

End: OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { PublicFilingHeader Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { LegalEvents Aggregate, boolean, Optional

Records legal actions targeting the subject, such as criminal proceedings, protested bills, county court judgments, receiverships, bankruptcies.

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { LegalEvents { BankruptcyIndicator Element, Optional
End: OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { LegalEvents Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { SignificantEvents Aggregate, Optional

Records information about key events which may affect the subject. It covers such things as: natural disasters (e.g., floods, hurricane), accidents (e.g., chemical spillage), major events at the business (e.g.,change of control,business interruption, awarded contract), societal events (e.g., war, civil disturbance).

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { SignificantEvents { SpecialEvent Aggregate, date, Optional (Array)

An entry loop which can repeat multiple times to allow the recording of information about a key event which may affect the subject. It covers such things as: natural disasters (e.g., floods, hurricane), accidents (e.g., chemical spillage), major events at the business (e.g.,change of control,business interruption, awarded contract), societal events (e.g., war, civil disturbance).

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { SignificantEvents { SpecialEvent { EventDate Element, Optional, [M+]

The date when the event took place.

Monitor Path: //Organization /Events /SignificantEvents /SpecialEvent

End: OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { SignificantEvents { SpecialEvent Aggregate
End: OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { SignificantEvents Aggregate
End: OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Financial Aggregate, Optional

Records a standardized view the financial results of a subject usually extracted from a set of accounts. This includes the financial period to which those results apply, the terms of its audited status, whether is fiscal or estimated, whether it is a group/consolidated or individual statement etc. The identifying data for the financial statement (e.g. The financial period to which it refers) and the 70 D&B global standard financial items are recorded in the 'Statement' aggregate. Additionally the full granular view of the financial statement may be recorded in the 'Financial Statement Schedule' sub-aggregation.

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Financial { KeyFinancialFiguresOverview Aggregate, Optional (Array)

An entry loop which can repeat multiple times to record highlights of the financial statements (Balance sheet, Income statement, cash flow statement etc.) across years and gives a snapshot view of how the company has been performing on items in these financial statements.

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Financial { KeyFinancialFiguresOverview { StatementHeaderDetails Aggregate, date, Optional

Records high level information which allows identification of the Financial Statement.

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Financial { KeyFinancialFiguresOverview { StatementHeaderDetails { FinancialStatementToDate Element, Optional

The date when the accounting period ended. If the Reliability Code denotes the figures are projected (future), then this is the date when the accounting period will end.

End: OrderProductResponse { OrderProductResponseDetail { Product { Organization { Financial { KeyFinancialFiguresOverview { StatementHeaderDetails Aggregate, decimal
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Financial { KeyFinancialFiguresOverview { TotalEquityAmount Element, Optional

The total value of share capital/stock originally invested by shareholders/stockholders plus any reserves which have arisen, such as retained profits, which are ploughed back into the firm. Also known as Net Worth.

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Financial { KeyFinancialFiguresOverview { TotalEquityAmount @UnitOfSize Attribute
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Financial { KeyFinancialFiguresOverview { TotalEquityAmount @CurrencyISOAlpha3Code Attribute
End: OrderProductResponse { OrderProductResponseDetail { Product { Organization { Financial { KeyFinancialFiguresOverview Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Financial { FinancialStatement Aggregate, Optional (Array)

An entry loop which can repeat multiple times to record information characterizing an organization's financial health, such as its operation results (over a specified period of time), the ownership equity in the business, its money management (at a point in time), and derived ratios that give insight into its profitability, solvency, liquidity, and other characteristics. The financial figures may be provided as actual or estimated figures by the subject, an outside source, or modeled by D&B. It may cover a single organization or multiple related organizations. The figures may be qualified based on the auditor's remarks.

NOTE: Historical financial data is not available for all countries other than the US. For some countries, only very limited financial data is available.

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Financial { FinancialStatement { StatementHeaderDetails Aggregate, date, Optional

Records high level information which either identifies the presence of a financial statement for the subject or is derived from multiple financial statements.

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Financial { FinancialStatement { StatementHeaderDetails { FinancialStatementToDate Element, string, up to 3 chars., Optional, [M+]

The date when the accounting period ended. If the Reliability Code denotes the figures are projected (future), then this is the date when the accounting period will end.

Monitor Path: //Organization /Financial /FinancialStatement

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Financial { FinancialStatement { StatementHeaderDetails { CurrencyISOAlpha3Code Element, string, up to 256 chars., Optional, [M+]

The three-letter code, published by International Organization for Standardization (ISO), identifying the type of money that is primarily used by this subject

Monitor Path: //Organization /Financial /FinancialStatement

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Financial { FinancialStatement { StatementHeaderDetails { UnitOfSizeText Element, Optional, [M+]

Text which identifies the unit of size in which the financial summary figures are provided, e.g., in 1,000s; in 1,000,000s. The financial figures should be populated to the record with the 000's or 000,000's omitted, e.g., If Sales are 54398 with 000's omitted then the figure of 54398 (NOT 54398000) should be populated.

Monitor Path: //Organization /Financial /FinancialStatement

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Financial { FinancialStatement { StatementHeaderDetails { UnitOfSizeText@DNBCodeValue Attribute
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Financial { FinancialStatement { StatementHeaderDetails { UnitOfSizeText@DNBCodeTableNumber Attribute
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Financial { FinancialStatement { StatementHeaderDetails { FinancialPeriodDuration Element, Optional, [M+]

Records the period of the Financial Summary when this cannot be expressed using 'Summary Date' and 'Number of Months'

Monitor Path: //Organization /Financial /FinancialStatement

END: OrderProductResponse { OrderProductResponseDetail { Product { Organization { Financial { FinancialStatement { StatementHeaderDetails Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Financial { FinancialStatement { BalanceSheet Aggregate, Optional

Summarizes an organization or individual's assets, equity and liabilities at a specific point in time.

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Financial { FinancialStatement { BalanceSheet { Liabilities Aggregate, Optional

Records the legal debts or obligations of a company  that arise during the course of business operations. Liabilities are settled over time through the transfer of economic benefits including money, goods or services.

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Financial { FinancialStatement { BalanceSheet { Liabilities { TotalEquityAmount Element, Optional, [M+]

The total value of share capital/stock originally invested by shareholders/stockholders plus any reserves which have arisen, such as retained profits, which are ploughed back into the firm.

Monitor Path: //Organization /Financial /FinancialStatement

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Financial { FinancialStatement { BalanceSheet { Liabilities { Equity { StatementItem Aggregate, Optional (Array)

An entry loop which can repeat multiple times to allow the recording of all of the details (financial items) for a specific schedule within the Financial Statement in terms of monetary amounts.

END: OrderProductResponse { OrderProductResponseDetail { Product { Organization { Financial { FinancialStatement { BalanceSheet { Liabilities Aggregate
END: OrderProductResponse { OrderProductResponseDetail { Product { Organization { Financial { FinancialStatement { BalanceSheet Aggregate
End: OrderProductResponse { OrderProductResponseDetail { Product { Organization { Financial Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationName Aggregate, Optional

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

OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationName { OrganizationPrimaryName Aggregate, string, up to 256 chars., Optional (Array)

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

OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationName { OrganizationPrimaryName { OrganizationName Element, Required

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

End: OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationName { OrganizationPrimaryName Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationName { TradeStyleName Aggregate, string, up to 256 chars., Optional (Array)

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

OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationName { TradeStyleName { OrganizationName Element, integer, up to 3 digits., Required, [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 Element, Optional

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
OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationName { DoNotConfuseOrganizationName Aggregate, string, up to 256 chars., Optional (Array)

An entry loop which can repeat multiple times to allow the recording of such names which could be very similar to the names of the subject and are very likely to be mistakenly used as the name of the subject. Note: This list is maintained so that using wrong names for a subject could be avoided.

OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationName { DoNotConfuseOrganizationName { OrganizationName Element, integer up to 3 digits., Required, [M+]

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

Monitor Path: //Organization /OrganizationName /DoNotConfuseOrganizationName

OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationName { DoNotConfuseOrganizationName { DisplaySequence Element, Optional

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 { DoNotConfuseOrganizationName Aggregate
End: OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationName Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationDetail Aggregate, Optional

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

OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationDetail { FamilyTreeMemberRole Aggregate, string, up to 256 chars., Optional (Array)

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

OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationDetail { FamilyTreeMemberRole { FamilyTreeMemberRoleText Element, Optional, [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.

Monitor Path: //Organization /OrganizationDetail /FamilyTreeMemberRole

OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationDetail { FamilyTreeMemberRole { FamilyTreeMemberRoleText @DNBCodeValue Attribute
End: OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationDetail { FamilyTreeMemberRole Aggregate, date
OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationDetail { ControlOwnershipDate Element, Optional

The date when the current owners took over this business.

OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationDetail { ControlOwnershipDate @DatePrecisionText Attribute, string, up to 256 chars.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationDetail { OperatingStatusText Element, Optional, [M+]

Text describing this organization's functional state / trading status, e.g. active, out of business, dormant.

Monitor Path: //Organization /OrganizationDetail /OperatingStatusText@DNBCodeValue

OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationDetail { OperatingStatusText @DNBCodeValue Attribute, boolean
OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationDetail { StandaloneOrganizationIndicator Element, integer, Optional

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

OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationDetail { OrganizationStartYear Element, boolean, Optional

The year when operations undertaken by the organization commenced.

OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationDetail { OutofBusinessIndicator Element, Optional

When turned ON (set to TRUE) it indicates that this organization is no longer functional / trading.When turned OFF (set to FALSE) it indicates that this organization is functioning / trading.

End: OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationDetail Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { IndustryCode Aggregate, Optional

Records the business activities in which an organization is actively engaged using standardized coding schemes such as European NACE and U.S. Standard Industry Classifications (SIC). Examples of business activities are: commercial printing, legal services, drug store, sheet metalwork fabricator.

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

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 @DNBCodeValue Attribute, string, up to 16 chars.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { IndustryCode { IndustryCode { IndustryCode Element, Required

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

OrderProductResponse { OrderProductResponseDetail { Product { Organization { IndustryCode { IndustryCode { IndustryCodeDescription Element, Optional (Array)

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

OrderProductResponse { OrderProductResponseDetail { Product { Organization { IndustryCode { IndustryCode { IndustryCodeDescription @WritingScriptISOAlpha4Code Attribute
OrderProductResponse { OrderProductResponseDetail { Product { Organization { IndustryCode { IndustryCode { IndustryCodeDescription @LanguageCode Attribute, integer, up to 3 digits.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { IndustryCode { IndustryCode { DisplaySequence Element, Optional

A number which may be used to define the order in which this industry code should be presented relative to other industry codes of the same type where the lower the number the earlier the data is presented.

End: OrderProductResponse { OrderProductResponseDetail { Product { Organization { IndustryCode { IndustryCode Aggregate
End: OrderProductResponse { OrderProductResponseDetail { Product { Organization { IndustryCode Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { ActivitiesAndOperations Aggregate, Optional

Records the description of operations continued by a business including market information such as the number of customers, agency details and import/export details.

OrderProductResponse { OrderProductResponseDetail { Product { Organization { ActivitiesAndOperations { LineOfBusinessDetails Aggregate, string, up to 3000 chars., Optional (Array)

An entry loop which can repeat multiple times to allow the recording of several different descriptions of operations continued by a business in different languages.

OrderProductResponse { OrderProductResponseDetail { Product { Organization { ActivitiesAndOperations { LineOfBusinessDetails { LineOfBusinessDescription Element, Optional, [M+]

Records the textual description of operations continued by a business.

Monitor Path: //Organization /ActivitiesAndOperations /LineOfBusinessDetails

End: OrderProductResponse { OrderProductResponseDetail { Product { Organization { ActivitiesAndOperations { LineOfBusinessDetails Aggregate
End: OrderProductResponse { OrderProductResponseDetail { Product { Organization { ActivitiesAndOperations Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { EmployeeFigures Aggregate, Optional

Records information about the number of people engaged by an organization to perform its business operations.Several different Employee Figures for a subject could be recorded, e.g., consolidated, individual entity, headquarters only. A further breakdown of employee figures is recorded based on employment basis (e.g., full time, part time, contract) and/or employee category (e.g., clerical, management, marketing, sales, blue collar).

OrderProductResponse { OrderProductResponseDetail { Product { Organization { EmployeeFigures { HeadquartersLocationEmployeeDetails Aggregate, long, Optional

Records current employee data of only the Headquarters location. The employees who are engaged in the operations of the organization and are located at the headquarters location (i.e. the organization has branch locations). Therefore, this employee figure excludes all persons located at branch locations and all persons employed by any subsidiaries. An Headquarters Only" figure therefore refers to a subset of the "Individual" employees and can never be applied to an which is classified by D&B as a "branch" location."

OrderProductResponse { OrderProductResponseDetail { Product { Organization { EmployeeFigures { HeadquartersLocationEmployeeDetails { TotalEmployeeQuantity Element, Optional

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

End: OrderProductResponse { OrderProductResponseDetail { Product { Organization { EmployeeFigures { HeadquartersLocationEmployeeDetails Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { EmployeeFigures { ConsolidatedEmployeeDetails Aggregate, long, Optional

Records current employee data which includes all employees who are engaged in the operations of the legal entity (including employees located at branch locations) as well as all employees who are engaged in the operations of every direct descendant in its family tree (based on controlling interest). I.e. Subsidiaries.  Note: An organization which is classified by D&B as a branch" location cannot have an "Consolidated" employee figure."

OrderProductResponse { OrderProductResponseDetail { Product { Organization { EmployeeFigures { ConsolidatedEmployeeDetails { TotalEmployeeQuantity Element, Optional

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

End: OrderProductResponse { OrderProductResponseDetail { Product { Organization { EmployeeFigures { ConsolidatedEmployeeDetails Aggregate
End: OrderProductResponse { OrderProductResponseDetail { Product { Organization { EmployeeFigures Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Assessment Aggregate, Optional

Records insightful and value added information on organizations, such as: - recommendations on how much credit to extend to them, - assessments of their liquidity, - concise evaluations of their performance and behavior, - predictions on the risk of conducting business with them. The predictive scores are usually calculated and assigned by D&B, but such assessments may also be recorded when assigned by third parties.

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Assessment { DNBStandardRating Aggregate, string, up to 64 chars., Optional

Records the most current Standard D&B Rating assigned to this organization.

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Assessment { DNBStandardRating { DNBStandardRating Element, Required

Text that Indicates the estimated financial strength and composite credit appraisal assigned by the Business Reporter on a subjective basis at the time the report is written.

End: OrderProductResponse { OrderProductResponseDetail { Product { Organization { Assessment { DNBStandardRating Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Assessment { FinancialStressScore Aggregate, date, Optional (Array)

An entry loop that repeats multiple times to allow the recording of the most recent risk scores that are assigned to this organization on a given date/time using a scoring model that help predict the likelihood that the organization will seek legal relief from creditors or cease operations without paying all creditors in full over the next 12 months.

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Assessment { FinancialStressScore { ScoreDate Element, Optional
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Assessment { FinancialStressScore { ScoreDate @DatePrecisionText Attribute
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Assessment { FinancialStressScore { ScoreDate @DatePrecisionDNBCodeValue Attribute, long
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Assessment { FinancialStressScore { RawScore Element, string, up to 3 chars., Optional

A numeric value that predicts the likelihood that the risk will occur.

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Assessment { FinancialStressScore { ClassScore Element, string, up to 240 chars., Optional

A one digit number from 0 to 5 based on the information in DNB file.A numeric value that succinctly expresses the likelihood of risk by specifying in which risk group this organization belongs. In other words, it specifies where this organization falls in a statistical distribution of all businesses (e.g, a bell curve, a half-normal distribution).

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Assessment { FinancialStressScore { ClassScoreDescription Element, decimal, up to 5 digits. Maximum of 2 decimal places., Optional

Text that describes the Class Score Value that expresses the likelihood of risk by specifying in which risk group this organization belongs.

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Assessment { FinancialStressScore { NationalPercentile Element, decimal, up to 10 digits. Maximum of 5 decimal places., Optional

A number that identifies where this organization's score falls relative to the scores of other businesses. As an example, if the percentile here is 10, it means that this organization's score is the same as or better than 10% of the businesses in D&B's information base, but not as good as 90% of the businesses.

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Assessment { FinancialStressScore { RiskIncidencePercentage Element, integer, Optional

A percentage that expresses the likelihood that the inferred risk (e.g., payment delinquency, discontinued operations) will occur for this organization. This percentage is determined based on which range this organization's score falls within a pre-determined set of score ranges. The ranges and percentages are determined through analysis of historical events.

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Assessment { FinancialStressScore { RiskIncidenceCount Element, Optional

The number of organizations with the same Class Score that have experienced the risk.

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Assessment { FinancialStressScore { ScoreCommentary Aggregate, string, up to 256 chars., Optional (Array)

An entry loop which can repeat multiple times to allow the recording of primary reasons for the score.

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Assessment { FinancialStressScore { ScoreCommentary { CommentaryText Element, Optional, [M+]

Text that explains the primary reasons for the score.

Monitor Path: //Organization /Assessment /FinancialStressScore /ScoreCommentary /CommentaryText@DNBCodeValue

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Assessment { FinancialStressScore { ScoreCommentary { CommentaryText @DNBCodeValue Attribute
End: OrderProductResponse { OrderProductResponseDetail { Product { Organization { Assessment { FinancialStressScore { ScoreCommentary Aggregate, integer
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Assessment { FinancialStressScore { AverageNationalRiskIncidenceCount Element, decimal, up to 5 digits. Maximum of 2 decimal places., Optional

The number of failures happened relative to the total number of failures happened of other businesses.

OrderProductResponse { OrderProductResponseDetail { Product { Organization { Assessment { FinancialStressScore { AverageNationalRiskIncidencePercentage Element, Optional

A percentage that express the Average number of Failures happened.

End: OrderProductResponse { OrderProductResponseDetail { Product { Organization { Assessment { FinancialStressScore Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Assessment { FinancialStressReferenceData Aggregate, Optional
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Assessment { FinancialStressReferenceData { RiskIncidence Aggregate, string, up to 16 chars., Optional (Array)
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Assessment { FinancialStressReferenceData { RiskIncidence { ClassScore Element, decimal, up to 5 digits. Maximum of 2 decimal places., Optional
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Assessment { FinancialStressReferenceData { RiskIncidence { RiskIncidenceScoreableUniverseSubjectPercentage Element, decimal, up to 16 digits. Maximum of 2 decimal places., Optional
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Assessment { FinancialStressReferenceData { RiskIncidence { RiskIncidenceRelativeToOverallRiskIncidencePercentage Element, Optional
End: OrderProductResponse { OrderProductResponseDetail { Product { Organization { Assessment { FinancialStressReferenceData { RiskIncidence Aggregate
End: OrderProductResponse { OrderProductResponseDetail { Product { Organization { Assessment { FinancialStressReferenceData Aggregate, string, up to 3000 chars.
OrderProductResponse { OrderProductResponseDetail { Product { Organization { Assessment { AssessmentSummaryText Element, Optional (Array)

Text that records a brief statement of the assessment.

End: OrderProductResponse { OrderProductResponseDetail { Product { Organization { Assessment Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { BusinessTrading Aggregate, boolean, Optional

Records references or opinions in terms of the timeliness of payment, the amounts of the transactions and the terms of sale applied to the transactions and summarized views of this data that involves the subject either as a buyer or supplier of goods or services.

OrderProductResponse { OrderProductResponseDetail { Product { Organization { BusinessTrading { TradeDataUnavailabilityIndicator Element, Optional
End: OrderProductResponse { OrderProductResponseDetail { Product { Organization { BusinessTrading Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement Aggregate, Optional

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

OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { MostSeniorPrincipal Aggregate, Optional

Records the details of the most important principal.

OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { MostSeniorPrincipal { PrincipalName Aggregate, Optional

Records the different names for the Principal.

OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { MostSeniorPrincipal { PrincipalName @type Attribute
OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { MostSeniorPrincipal { PrincipalName { FirstName Element
OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { MostSeniorPrincipal { PrincipalName { MiddleName Element
OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { MostSeniorPrincipal { PrincipalName { LastName Element
OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { MostSeniorPrincipal { PrincipalName { FullName Element
OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { MostSeniorPrincipal { PrincipalName { OrganizationPrimaryName Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { MostSeniorPrincipal { PrincipalName { OrganizationPrimaryName { OrganizationName Element
End: OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { MostSeniorPrincipal { PrincipalName { OrganizationPrimaryName Aggregate
End: OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { MostSeniorPrincipal { PrincipalName Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { MostSeniorPrincipal { Position Aggregate, string, up to 256 chars., Optional (Array)

An entry loop which can repeat multiple times to allow the recording of a job that is or was held by the principal or manager using D&B standardized codes. For instance, whether the position has been described to D&B as Financial Director, Finance Director, or Director of Finance, it will be mapped to a single code described as Financial Director.

OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { MostSeniorPrincipal { Position { PositionText Element, Required, [M+]

Text which denotes the job position the principal or manager holds or has held in the organization, e.g., Financial Director, Managing Director, Sales Director, Operations Manager.

Monitor Path: //Organization /PrincipalsAndManagement /MostSeniorPrincipal

End: OrderProductResponse { OrderProductResponseDetail { Product { Organization { PrincipalsAndManagement { MostSeniorPrincipal { Position Aggregate
End: OrderProductResponse { OrderProductResponseDetail { Product { Organization Aggregate
OrderProductResponse { OrderProductResponseDetail { Product { ArchiveDetail Aggregate, Optional
OrderProductResponse { OrderProductResponseDetail { Product { ArchiveDetail { PortfolioAssetID Element, long, Required
OrderProductResponse { OrderProductResponseDetail { Product { ArchiveDetail { PortfolioAssetContainerID Element, Optional
End: OrderProductResponse { OrderProductResponseDetail { Product { ArchiveDetail Aggregate, string, up to 128 chars.
OrderProductResponse { OrderProductResponseDetail { Product { CopyrightNoticeText Element, Optional

Text that specifies the underlying claim to copyright ownership of this product.

End: OrderProductResponse { OrderProductResponseDetail { Product Aggregate
OrderProductResponse { OrderProductResponseDetail { InquiryReferenceDetail Aggregate, string, up to 240 chars., Optional

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

OrderProductResponse { OrderProductResponseDetail { InquiryReferenceDetail { CustomerReferenceText Element, string, at least 1 chars. up to 240 chars., Optional(Up to 5x)

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

OrderProductResponse { OrderProductResponseDetail { InquiryReferenceDetail { CustomerBillingEndorsementText Element, Optional

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

End: OrderProductResponse { OrderProductResponseDetail { InquiryReferenceDetail Aggregate
End: OrderProductResponse { OrderProductResponseDetail Aggregate
End: OrderProductResponse Aggregate

Legend: [C] = may be included in a Custom Data product; [M] = may be referenced by the Monitoring process; [M+] = Monitored using an aggregate or attribute XPath.

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

Empty/NULL Values

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

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.

Response Codes & Error Handling

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

This operation may return the following response codes: CM001-CM005, CM007-CM012, CM014, CM017, CM018, PD001, PD003, PD005, PD006, PD015, PD016, and SC001-SC012.

NOTE: 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
Bankruptcy Indicator When 'true' indicates that bankruptcy information irrespective of its status (e.g., open, closed) is recorded in the D&B database for this subject. [M]

PCM XPath: //Organization/ Events/ LegalEvents/ BankruptcyIndicator

Business Commentary Text Text that records a brief statement of the subject company's assessment [M]

PCM XPath: //Organization/ Assessment/ AssessmentSummaryText

Control Year The date when the current owners took over this business. [M]

PCM XPath: //Organization/ OrganizationDetail/ ControlOwnershipDate

D&B Files Represented Percentage A percentage specifying the files for a corresponding Financial Stress Class that are in the D&B data base. [M]

PCM XPath: //Organization/ Assessment/ FinancialStressReferenceData/ RiskIncidence/ RiskIncidenceScoreableUniverseSubjectPercentage

D&B Rating Text describing the estimated financial strength and composite credit appraisal assigned to the subject at the time of last update. [M]

PCM XPath: //Organization/ Assessment/ DNBStandardRating/ DNBStandardRating

Do Not Confuse with Organization Name Text recording a name which could be very similar to the name of the subject and is very likely to be mistakenly used as the name of the subject. [M+]

PCM XPath: //Organization/ OrganizationName/ DoNotConfuseOrganizationName/ OrganizationName

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 (Headquarter 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 headquarter location. [M]

PCM XPath: //Organization/ EmployeeFigures/ HeadquartersLocationEmployeeDetails/ TotalEmployeeQuantity

Financial Statement Currency Code The three-letter code, published by International Organization for Standardization (ISO), identifying the type of money that corresponds to the values in the financial statement. [M+]

PCM XPath: //Organization/ Financial/ FinancialStatement/ StatementHeaderDetails/ CurrencyISOAlpha3Code

Financial Statement Date The date when the accounting period ended. If the accounting figures are projected (future), then this is the date when the accounting period will end. [M+]

PCM XPath: //Organization/ Financial/ FinancialStatement/ StatementHeaderDetails/ FinancialStatementToDate

Financial Statement Period The period of the financial statement expressed as a number of years, months or days. (e.g. P3M is 3 months or quarterly, P1Y is 1 year or annual)

PCM XPath: //Organization/ Financial/ FinancialStatement/ StatementHeaderDetails/ FinancialPeriodDuration

Financial Statement Unit of Size Text which identifies the unit of size that corresponds to the values in the financial statement. [M+]

PCM XPath: //Organization/ Financial/ FinancialStatement/ StatementHeaderDetails/ UnitOfSizeText

Financial Stress Score Class Description Text that describes the Financial Stress Class Score by specifying in which risk group this organization belongs. [M]

PCM XPath: //Organization/ Assessment/ FinancialStressScore/ ClassScoreDescription

Financial Stress Score Class Score A one digit number from 0 to 5 assigned to the business based on information in D&B's file. The higher the class score the greater the likelihood that the organization will seek legal relief from creditors or cease operations without paying all of its cre [M]

PCM XPath: //Organization/ Assessment/ FinancialStressScore/ ClassScore

Financial Stress Score Commentary Text Text that explains the primary reasons for the financial stress score. [M+]

PCM XPath: //Organization/ Assessment/ FinancialStressScore/ ScoreCommentary/ CommentaryText

Financial Stress Score Date The date on which the score was calculated. [M]

PCM XPath: //Organization/ Assessment/ FinancialStressScore/ ScoreDate

Financial Stress Score National Percentile A number that identifies where this organization's score falls relative to the scores of other businesses. As an example if the percentile here is 10 it means that this organization's score is the same as or better than 10% of the businesses in D&B's data [M]

PCM XPath: //Organization/ Assessment/ FinancialStressScore/ NationalPercentile

Financial Stress Score Raw Score A numeric value that predicts the likelihood that the organization will seek legal relief from creditors or cease operations without paying all of its creditors in full in the next 12 months. (May be referred to as the Global Failure Score in some markets [M]

PCM XPath: //Organization/ Assessment/ FinancialStressScore/ RawScore

Financial Stress Score Risk Incidence Count A count of the number of organizations that have the same Class Score and have experienced financial stress. [M]

PCM XPath: //Organization/ Assessment/ FinancialStressScore/ RiskIncidenceCount

Financial Stress Score Risk Incidence Count - National Average The count of the number of failures that happened within this industry relative to the total number of failures that happened for all businesses. [M]

PCM XPath: //Organization/ Assessment/ FinancialStressScore/ AverageNationalRiskIncidenceCount

Financial Stress Score Risk Incidence Percentage A percentage specifying the likelihood that the organization will seek legal relief from creditors or cease operations without paying all of its creditors in full in the next 12 months. This percentage is determined based on which range this organization' [M]

PCM XPath: //Organization/ Assessment/ FinancialStressScore/ RiskIncidencePercentage

Financial Stress Score Risk Incidence Percentage - Industry Average A percentage specifying a corresponding Financial Stress Class as it relates to the Industry Average. [M]

PCM XPath: //Organization/ Assessment/ FinancialStressReferenceData/ RiskIncidence/ RiskIncidenceRelativeToOverallRiskIncidencePercentage

Financial Stress Score Risk Incidence Percentage - National Average A percentage specifying the Average number of Failures that happened. [M]

PCM XPath: //Organization/ Assessment/ FinancialStressScore/ AverageNationalRiskIncidencePercentage

Line of Business Text that records the description of operations continued by a business. [M+]

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

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

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

Most Senior Principal Position Text recording the title of the primary executive. [M+]

PCM XPath: //Organization/ PrincipalsAndManagement/ MostSeniorPrincipal/ Position/ PositionText

Organization Start Year The year when operations undertaken by the organization commenced. [M]

PCM XPath: //Organization/ OrganizationDetail/ OrganizationStartYear

Out of Business Indicator Text that records the operating status of the business. [M+]

PCM XPath: //Organization/ OrganizationDetail/ OperatingStatusText

Out of Business Indicator (Standalone) When 'true' indicates that this organization is no longer functional / trading. When 'false' indicates that this organization is functioning / trading.

PCM XPath: //Organization/ OrganizationDetail/ OutofBusinessIndicator

Primary SIC Code The code represents an activity in which the organization engages in.  A business may have up to five activities in which it participates.

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

Special Event Date The date when the special event took place.

PCM XPath: //Organization/ Events/ SignificantEvents/ SpecialEvent/ EventDate

Total Equity Amount The total value of share capital/stock originally invested by shareholders/stockholders plus any reserves which have arisen such as retained profits which are ploughed back into the firm. Also known as Net Worth. [M+]

PCM XPath: //Organization/ Financial/ FinancialStatement/ BalanceSheet/ Liabilities/ TotalEquityAmount

Trade Experience Data Unavailable Indicator When 'true' indicates that there are no trade experiences in the D&B files for this business. [M]

PCM XPath: //Organization/ BusinessTrading/ TradeDataUnavailabilityIndicator

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

D&B defines stress as: Obtaining legal relief from creditors; ceasing business operations without paying all creditors in full over the next twelve months; voluntarily withdrawing from business operation, leaving unpaid obligations; or going into receivership, reorganization, or making an arrangement for the benefit of creditors.

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.