UCC Filings
| Product Code(s) | PUBREC_UCC |
| Level(s) | Standard |
| Monitoring Available | No |
| Interface | REST |
| Method | GET |
| Format(s) | JSON |
| Service | PublicRecord |
| {version} | 3.2 |
| Initial Release | May 17, 2019 |
This product contains detailed information on the ten most recent Uniform Commercial Code (UCC) filing families* matched to a D-U-N-S Number, which are not suppressed from appearing in product via a filing stop code. The information made available includes, but is not limited to, the filing type, all debtors, secured parties and assignees, and filing office information.
This product also contains key information from the D&B Business Information Report (BIR), such as primary name and trade style(s). If the D-U-N-S Number is that of a company headquarters, UCC filings matched to any branch of the headquarters will also be included.
*A “family” may contain multiple UCC filing types, such as original, amendment, continuation, termination, which are linked together by an original UCC Number.
Update History
- October 11, 2024 (ALL SOAP & REST): Updated Primary Address (Territory and Country) mapping for Russia market.
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 a country code of "US".
A trade up option exists to request data for a headquarters location when the requested organization is a branch.
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 "UCC Filings" 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
GET https://direct.dnb.com/V3.0/organizations/804735132/products/PUBREC_UCC Authorization: <My Token>
| Name | Characteristics |
|---|---|
| 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 |
| 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. Possible values: US |
| {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). |
| 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. |
| 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. |
| {productID} | string, Required An alphanumeric string that uniquely identifies the product being requested. |
| LanguagePreferenceCode | integer, up to 7 digits, Optional Possible values: 39 (English) |
| 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 |
| ApplicationTransactionID | string, up to 64 chars, Optional A number assigned by the calling application to uniquely identify this request. |
| 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. |
| 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. |
| {version} | Element |
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 (PublicRecord) |
|---|
| 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.
| Product | D-U-N-S Number (Country Code) |
|---|---|
| Business Registrations | 804735132 (US) |
| Judgments | 804735132 (US) |
| Liens | 804735132 (US) |
| Corporate Entity Type & Ownership | 804735132 (US) |
| Suits | 362328580 (US) |
| UCC Filings | 804735132 (US) |
| Suits, Liens, Judgments & Bankruptcies - Detail | 804735132 (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.
{"OrderProductResponse": {
"@ServiceVersionNumber": "3.0",
"TransactionDetail": {
"ServiceTransactionID": "Id-3db9545572a52b0074860e00b27f2c55-2",
"TransactionTimestamp": "2015-05-14T11:03:26.734-04:00"
},
"TransactionResult": {
"SeverityText": "Information",
"ResultID": "CM000",
"ResultText": "Success"
},
"OrderProductResponseDetail": {
"InquiryDetail": {
"DUNSNumber": "804735132",
"CountryISOAlpha2Code": "US"
},
"Product": {
"DNBProductID": "PUBREC_UCC",
"Organization": {
"SubjectHeader": {
"DUNSNumber": "804735132",
"LastUpdateDate": {"$": "2012-04-19"}
},
"Telecommunication": {"TelephoneNumber": [ {
"TelecommunicationNumber": "(978) 461-1234",
"InternationalDialingCode": "1"
}]},
"Location": {"PrimaryAddress": {
"StreetAddressLine": [{"LineText": "492 Koller Street"}],
"PrimaryTownName": "San Francisco",
"CountryISOAlpha2Code": "US",
"TerritoryAbbreviatedName": "CA",
"PostalCode": "94110",
"TerritoryOfficialName": "Florida"
}},
"Events": {
"PublicFilingHeader": {"DisclaimerText": "THE PUBLIC RECORD ITEMS REPORTED MAY HAVE BEEN PAID, TERMINATED, VACATED OR RELEASED PRIOR TO THE DATE THIS DATA IS TRANSMITTED"},
"FinancingEvents": {"FinancingStatementFilingInformation": {
"FinancialStatementFilingSummary": {"TotalFilingCount": 1},
"FinancialStatementFiling": [ {
"FilingTypeText": {
"@DNBCodeValue": 11293,
"$": "Original"
},
"FilingDate": {"$": "2010-06-30"},
"FilingTime": "2015-05-14T13:58:00.000",
"ReceivedDate": {"$": "2010-07-07"},
"VerifiedDate": {"$": "2010-11-18"},
"FilingReferenceNumber": "201081314400",
"RolePlayer": [
{
"RolePlayerTypeText": {
"@DNBCodeValue": 3730,
"$": "Debtors"
},
"RolePlayerName": "VERNE Q. POWELL FLUTES, INC.",
"RolePlayerLocation": {
"StreetAddressLine": [{"LineText": "1 CLOCK TOWER PLACE, SUITE 300"}],
"PrimaryTownName": "MAYNARD",
"TerritoryAbbreviatedName": "MA",
"PostalCode": "01754"
}
},
{
"RolePlayerTypeText": {
"@DNBCodeValue": 14107,
"$": "Filing Office"
},
"RolePlayerName": "SECRETARY OF STATE/UCC DIVISION",
"RolePlayerLocation": {
"StreetAddressLine": [{"LineText": "1 ASHBURTON PL STE 1711"}],
"PrimaryTownName": "BOSTON",
"TerritoryAbbreviatedName": "MA",
"PostalCode": "02108"
}
},
{
"RolePlayerTypeText": {
"@DNBCodeValue": 14802,
"$": "Assignee"
},
"RolePlayerName": "BROOKLINE BANK",
"RolePlayerLocation": {
"StreetAddressLine": [{"LineText": "160 WASHINGTON STREET"}],
"PrimaryTownName": "BROOKLINE",
"TerritoryAbbreviatedName": "MA",
"PostalCode": "02445"
}
}
]
}]
}}
},
"OrganizationName": {
"OrganizationPrimaryName": {"OrganizationName": {"$": "Gorman Manufacturing Company, Inc."}},
"TradeStyleName": [{"OrganizationName": {"$": "Gorman Inc."}}]
},
"OrganizationDetail": {"StandaloneOrganizationIndicator": true}
},
"ArchiveDetail": {"PortfolioAssetID": 102140721}
},
"InquiryReferenceDetail": null
}
}}
| 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 { 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 [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 { LastUpdateDate | date, Optional [M] The date when the subject's record was last updated on D&B's system. |
| END: OrderProductResponse } OrderProductResponseDetail } Product } Organization } SubjectHeader | /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. |
| OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { PublicFilingHeader { DisclaimerText | string, up to 720 chars, Optional [M] The text that intended to specify or delimit the scope of rights and obligations that may be exercised and enforced by parties in a legally-recognized relationship. In contrast to other terms for legally operative language, the term disclaimer usually implies situations that involve some level of uncertainty, waiver, or risk. |
| END: OrderProductResponse } OrderProductResponseDetail } Product } Organization } Events } PublicFilingHeader | /Aggregate |
| OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { FinancingEvents | Aggregate, Optional Records the information about the events which have occurred and directly affect the subject's finances. For example, the means by which moneys are obtained by the subject, financial securities which have been filed which affect the subject. |
| OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { FinancingEvents { FinancingStatementFilingInformation | Aggregate, Optional Records the information about financing agreement which has been filed under the Personal Property Security Act; consolidates all transactions involving granting of personal property security, e.g., chattel mortgage, assignment book debts. |
| OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { FinancingEvents { FinancingStatementFilingInformation { FinancialStatementFilingSummary | Aggregate, Optional Records the summarized information about financing agreement which has been filed under the the US Uniform Commercial Code (UCC) in different time periods. |
| OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { FinancingEvents { FinancingStatementFilingInformation { FinancialStatementFilingSummary { TotalFilingCount | integer, Optional The total number of all legal events of the type covered by this summary. |
| END: OrderProductResponse } OrderProductResponseDetail } Product } Organization } Events } FinancingEvents } FinancingStatementFilingInformation } FinancialStatementFilingSummary | /Aggregate |
| OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { FinancingEvents { FinancingStatementFilingInformation { FinancialStatementFiling | Aggregate, Optional (Array) An entry loop which can repeat multiple times to allow the recording of the information about financing agreement which has been filed under the the US Uniform Commercial Code (UCC) Act and Personal Property Security Act in Canada; consolidates all transactions involving granting of personal property security, e.g., chattel mortgage, assignment book debts. |
| OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { FinancingEvents { FinancingStatementFilingInformation { FinancialStatementFiling { FilingTypeText | string, up to 256 chars, Optional [M+] Text that describes the type of the action the subject has taken to raise money for running operations or making investments in the business, e.g., UCC Financing Statement Filing. Monitor Path: //Organization /Events /FinancingEvents /FinancingStatementFilingInformation /FinancialStatementFiling |
| OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { FinancingEvents { FinancingStatementFilingInformation { FinancialStatementFiling { CollateralDetail | Aggregate, Optional (Array) An entry loop which can repeat multiple times to allow the recording of several different types of assets used by the subject as security for this event. |
| OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { FinancingEvents { FinancingStatementFilingInformation { FinancialStatementFiling { CollateralDetail { CollateralClassText | string, up to 256 chars, Optional [M+] Text value describing the class of asset used by the subject as security when obtaining a loan, e.g., Land, Buildings, Personal Assets, Cash Reserves. Possible values: 14794 [Specified]; 11287 [All]; 11288 [Leased]; 0 [Unknown] Monitor Path: //Organization /Events /FinancingEvents /FinancingStatementFilingInformation /FinancialStatementFiling |
| OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { FinancingEvents { FinancingStatementFilingInformation { FinancialStatementFiling { CollateralDetail { CollateralTypeText | string, up to 256 chars, Optional Text describing the type of asset used as collateral at a detailed level, e.g., Cars, Office Block, Ships. |
| OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { FinancingEvents { FinancingStatementFilingInformation { FinancialStatementFiling { CollateralDetail { CollateralTypeDescription | string, up to 256 chars, Optional Free form text that describes the collateral type associated with this event. This is applicable only when Collateral Type Text is not present. |
| OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { FinancingEvents { FinancingStatementFilingInformation { FinancialStatementFiling { CollateralDetail { CollateralSupplementalItemTypeText | string, up to 256 chars, Optional (Array) Text that specifies the kind of supplemental items, (e.g., Products, Proceeds), that are included as security along with the identified collateral item for the given Collateral Type. The items in this example are produced as output of the asset (e.g., manufacturing plant) that the subject is using for collateral. Possible values: 11290 [Proceeds]; 11291 [Proceeds and Products]; 11289 [Products] |
| END: OrderProductResponse } OrderProductResponseDetail } Product } Organization } Events } FinancingEvents } FinancingStatementFilingInformation } FinancialStatementFiling } CollateralDetail | /Aggregate |
| OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { FinancingEvents { FinancingStatementFilingInformation { FinancialStatementFiling { ContactEvent | Aggregate, Optional (Array) An entry loop which can repeat multiple times to allow the recording of several different communications with persons with whom D&B had contact to get information on this event. |
| OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { FinancingEvents { FinancingStatementFilingInformation { FinancialStatementFiling { ContactEvent { ContactDate | date, Optional The date on which the communication took place |
| OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { FinancingEvents { FinancingStatementFilingInformation { FinancialStatementFiling { ContactEvent { ContactName | Aggregate, Optional The name of the person with whom D&B had contact to get information. |
| OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { FinancingEvents { FinancingStatementFilingInformation { FinancialStatementFiling { ContactEvent { ContactName { FullName | string, up to 256 chars, Optional The entire name of the subject where the subject is either an individual or an organization. |
| END: OrderProductResponse } OrderProductResponseDetail } Product } Organization } Events } FinancingEvents } FinancingStatementFilingInformation } FinancialStatementFiling } ContactEvent } ContactName | /Aggregate |
| OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { FinancingEvents { FinancingStatementFilingInformation { FinancialStatementFiling { ContactEvent { ContactOrganizationName | string, up to 256 chars, Optional (Array) The name of the organization that employs the person with whom D&B had contact to get information. |
| OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { FinancingEvents { FinancingStatementFilingInformation { FinancialStatementFiling { ContactEvent { ContactJobTitle | string, up to 128 chars, Optional (Array) A textual presentation of the Position Text as preferred by the person with whom D&B had contact to get information on this legal event. For example, the Position Code might equate to Financial Director but the Vanity Title might be Senior Director of Finance"." |
| OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { FinancingEvents { FinancingStatementFilingInformation { FinancialStatementFiling { ContactEvent { ContactEventText | Aggregate, Optional (Array) An entry loop which can repeat multiple times to allow the recording of textual information from this contact providing more details on the subject. Possible values: 14765 [Financing Statement was terminated]; 14766 [Financing Statement was continued]; 14767 [Financing Statement was assigned]; 14768 [Financing Statement was released]; 0 [Unknown] |
| OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { FinancingEvents { FinancingStatementFilingInformation { FinancialStatementFiling { ContactEvent { ContactEventText { TextTypeDescription | string, up to 256 chars, Required Text that provides meaning to the text found in the field named Text. |
| OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { FinancingEvents { FinancingStatementFilingInformation { FinancialStatementFiling { ContactEvent { ContactEventText { Text | string, up to 3000 chars, Required Text that has been recorded. |
| END: OrderProductResponse } OrderProductResponseDetail } Product } Organization } Events } FinancingEvents } FinancingStatementFilingInformation } FinancialStatementFiling } ContactEvent } ContactEventText | /Aggregate |
| OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { FinancingEvents { FinancingStatementFilingInformation { FinancialStatementFiling { ContactEvent { ContactPositionText | string, up to 256 chars, Optional (Array) |
| END: OrderProductResponse } OrderProductResponseDetail } Product } Organization } Events } FinancingEvents } FinancingStatementFilingInformation } FinancialStatementFiling } ContactEvent | /Aggregate |
| OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { FinancingEvents { FinancingStatementFilingInformation { FinancialStatementFiling { ContractTypeText | string, up to 256 chars, Optional Text that represents the type of contractual agreement which has been made between the secured party and debtor in a financing statement (e.g. Lease, rental, sale, refinance). Possible values: 14811 [Lease]; 14812 [Rental]; 14814 [Sale]; 14813 [Refinance]; 14815 [Wholesale]; 0 [Unknown] |
| OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { FinancingEvents { FinancingStatementFilingInformation { FinancialStatementFiling { FilingExpirationDate | date, Optional The date upon which the financing agreement will cease to be effective. For example a UCC filed on 2005-11-15 is effective from 2006-01-01 until 2006-12-31. The expiration date is 2006-12-31. |
| OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { FinancingEvents { FinancingStatementFilingInformation { FinancialStatementFiling { FilingDate | date, Optional [M+] The date when this financing agreement was filed under the US Uniform Commercial Code Act. Monitor Path: //Organization /Events /FinancingEvents /FinancingStatementFilingInformation /FinancialStatementFiling |
| OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { FinancingEvents { FinancingStatementFilingInformation { FinancialStatementFiling { FilingReferenceNumber | string, up to 32 chars, Optional [M+] The identifing number assigned by the recording office or court to the UCC filing. Monitor Path: //Organization /Events /FinancingEvents /FinancingStatementFilingInformation /FinancialStatementFiling |
| OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { FinancingEvents { FinancingStatementFilingInformation { FinancialStatementFiling { ReceivedDate | date, Optional The date when the information about the financing agreement which has been filed under the US Uniform Commercial Code Act, that involves this subject as recorded on the D&B database. was obtained by D&B |
| OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { FinancingEvents { FinancingStatementFilingInformation { FinancialStatementFiling { VerifiedDate | date, Optional The date on which D&B reviewed the reported content of this financing agreement which has been filed under the US Uniform Commercial Code Act, to ensure accuracy. |
| OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { FinancingEvents { FinancingStatementFilingInformation { FinancialStatementFiling { RolePlayer | Aggregate, Optional (Array) An entry loop which can repeat multiple times to allow the recording of various parties involved in this event as recorded in court papers and identifies the part each one plays, e.g., the creditor, debtor, plaintiff, defendant, solicitor, liquidator, trustee. |
| OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { FinancingEvents { FinancingStatementFilingInformation { FinancialStatementFiling { RolePlayer { RolePlayerTypeText | string, up to 256 chars, Optional [M+] Text describing the function played by this party in the event, e.g., debtor, creditor, liquidator, shareholder, court, plaintiff, defendant. Possible values: 3730 [Debtor]; 14083 [Authorised Signatory]; 14801 [Secured Party]; 14802 [Assignee]; 14107 [Filing Office] Monitor Path: //Organization /Events /FinancingEvents /FinancingStatementFilingInformation /FinancialStatementFiling |
| OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { FinancingEvents { FinancingStatementFilingInformation { FinancialStatementFiling { RolePlayer { RolePlayerTypeText @DNBCodeValue | integer, up to 7 digits, Attribute (1x) Possible values: 3730 [Debtor]; 14083 [Authorised Signatory]; 14801 [Secured Party]; 14802 [Assignee]; 14107 [Filing Office] |
| OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { FinancingEvents { FinancingStatementFilingInformation { FinancialStatementFiling { RolePlayer { RolePlayerName | string, up to 240 chars, Optional [M+] The name of the party involved in this event, as it was filed. Monitor Path: //Organization /Events /FinancingEvents /FinancingStatementFilingInformation /FinancialStatementFiling |
| OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { FinancingEvents { FinancingStatementFilingInformation { FinancialStatementFiling { RolePlayer { RolePlayerPosition | Aggregate, Optional (Array) An entry loop which can repeat multiple times to allow the recording of the details of the job that is currently held or was previously held in an organization by the party involved in this event. |
| OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { FinancingEvents { FinancingStatementFilingInformation { FinancialStatementFiling { RolePlayer { RolePlayerPosition { PositionText | string, up to 256 chars, Required 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. |
| END: OrderProductResponse } OrderProductResponseDetail } Product } Organization } Events } FinancingEvents } FinancingStatementFilingInformation } FinancialStatementFiling } RolePlayer } RolePlayerPosition | /Aggregate |
| OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { FinancingEvents { FinancingStatementFilingInformation { FinancialStatementFiling { RolePlayer { RolePlayerLocation | Aggregate, Optional Records the address of this party involved in the event, as it was filed. |
| OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { FinancingEvents { FinancingStatementFilingInformation { FinancialStatementFiling { RolePlayer { RolePlayerLocation { StreetAddressLine | Aggregate, Optional (Array) An entry loop which can repeat multiple times to allow the recording of several lines where each address line contains one or more named address elements. Examples of named address elements are Street Name, Street Number, Building Name, Estate Name. They are called “lines” because an addres can be divided into multiple lines. When there are multiple lines the sequence of the lines must be preserved. |
| OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { FinancingEvents { FinancingStatementFilingInformation { FinancialStatementFiling { RolePlayer { RolePlayerLocation { StreetAddressLine { LineText | string, up to 240 chars, Required [M+] Text that records the street address components as it would be presented on an address label. This includes, but is not limited to, details such as street name, street number, building name, estate name. Monitor Path: //Organization /Events /FinancingEvents /FinancingStatementFilingInformation /FinancialStatementFiling |
| END: OrderProductResponse } OrderProductResponseDetail } Product } Organization } Events } FinancingEvents } FinancingStatementFilingInformation } FinancialStatementFiling } RolePlayer } RolePlayerLocation } StreetAddressLine | /Aggregate |
| OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { FinancingEvents { FinancingStatementFilingInformation { FinancialStatementFiling { RolePlayer { RolePlayerLocation { PrimaryTownName | string, up to 64 chars, Optional [M+] The name of the town or city recognized by the Postal Authority for delivering mail. Monitor Path: //Organization /Events /FinancingEvents /FinancingStatementFilingInformation /FinancialStatementFiling |
| OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { FinancingEvents { FinancingStatementFilingInformation { FinancialStatementFiling { RolePlayer { RolePlayerLocation { 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 for this address. |
| OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { FinancingEvents { FinancingStatementFilingInformation { FinancialStatementFiling { RolePlayer { RolePlayerLocation { 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 { Events { FinancingEvents { FinancingStatementFilingInformation { FinancialStatementFiling { RolePlayer { RolePlayerLocation { TerritoryAbbreviatedName | string, up to 64 chars, Optional [M+] The shortened name of the locally governed area which forms part of a centrally governed nation. For example 'NJ' for the US State New Jersey within Country United States of America. Monitor Path: //Organization /Events /FinancingEvents /FinancingStatementFilingInformation /FinancialStatementFiling |
| OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { FinancingEvents { FinancingStatementFilingInformation { FinancialStatementFiling { RolePlayer { RolePlayerLocation { PostalCode | string, up to 16 chars, Optional [M+] An identifier used by the local country Postal Authority to identify a particular geographic location. For example, in Belgium, Postal Code 9000 identifies the town of GHENT. Monitor Path: //Organization /Events /FinancingEvents /FinancingStatementFilingInformation /FinancialStatementFiling |
| OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { FinancingEvents { FinancingStatementFilingInformation { FinancialStatementFiling { RolePlayer { RolePlayerLocation { CountyOfficialName | string, up to 64 chars, Optional |
| OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { FinancingEvents { FinancingStatementFilingInformation { FinancialStatementFiling { RolePlayer { RolePlayerLocation { CountryOfficialName | string, up to 64 chars, Optional |
| END: OrderProductResponse } OrderProductResponseDetail } Product } Organization } Events } FinancingEvents } FinancingStatementFilingInformation } FinancialStatementFiling } RolePlayer } RolePlayerLocation | /Aggregate |
| OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { FinancingEvents { FinancingStatementFilingInformation { FinancialStatementFiling { RolePlayer { RolePlayerJobTitle | Aggregate, Optional (Array) |
| OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { FinancingEvents { FinancingStatementFilingInformation { FinancialStatementFiling { RolePlayer { RolePlayerJobTitle { JobTitleText | string, up to 3000 chars, Optional Text that denotes a position held by the principal or manager. |
| END: OrderProductResponse } OrderProductResponseDetail } Product } Organization } Events } FinancingEvents } FinancingStatementFilingInformation } FinancialStatementFiling } RolePlayer } RolePlayerJobTitle | /Aggregate |
| END: OrderProductResponse } OrderProductResponseDetail } Product } Organization } Events } FinancingEvents } FinancingStatementFilingInformation } FinancialStatementFiling } RolePlayer | /Aggregate |
| OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { FinancingEvents { FinancingStatementFilingInformation { FinancialStatementFiling { FilingPageQuantity | integer, Optional The number of pages that make up the financing statement filed with the filing office. |
| OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { FinancingEvents { FinancingStatementFilingInformation { FinancialStatementFiling { FilingTime | dateTime, Optional The time of day at which this financing agreement was filed under the US Uniform Commercial Code Act, expressed in hours and minutes. |
| END: OrderProductResponse } OrderProductResponseDetail } Product } Organization } Events } FinancingEvents } FinancingStatementFilingInformation } FinancialStatementFiling | /Aggregate |
| OrderProductResponse { OrderProductResponseDetail { Product { Organization { Events { FinancingEvents { FinancingStatementFilingInformation { DisclaimerText | string, up to 720 chars, Optional Text that records a statement regarding the information recorded in this legal event. |
| END: OrderProductResponse } OrderProductResponseDetail } Product } Organization } Events } FinancingEvents } FinancingStatementFilingInformation | /Aggregate |
| END: OrderProductResponse } OrderProductResponseDetail } Product } Organization } Events } FinancingEvents | /Aggregate |
| END: OrderProductResponse } OrderProductResponseDetail } Product } Organization } Events | /Aggregate |
| OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationDetail | Aggregate, Optional Records fundamental information about a Subject which may vary over time. |
| OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationDetail { FamilyTreeMemberRole | Aggregate, Optional (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. Possible values: 202 [Family Tree Member Role] |
| OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationDetail { FamilyTreeMemberRole { FamilyTreeMemberRoleText | string, up to 256 chars, 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. Possible values: Branch (12769); Headquarters (12771) Monitor Path: //Organization /OrganizationDetail /FamilyTreeMemberRole |
| END: OrderProductResponse } OrderProductResponseDetail } Product } Organization } OrganizationDetail } FamilyTreeMemberRole | /Aggregate |
| OrderProductResponse { OrderProductResponseDetail { Product { Organization { OrganizationDetail { StandaloneOrganizationIndicator | boolean, Optional [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. |
| END: OrderProductResponse } OrderProductResponseDetail } Product } Organization } OrganizationDetail | /Aggregate |
| END: OrderProductResponse } OrderProductResponseDetail } Product } Organization | /Aggregate |
| END: OrderProductResponse } OrderProductResponseDetail } Product | /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,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 |
|---|---|
| Additional UCC Filings Disclaimer Text | Text recording the additional financing statements disclaimer. PCM XPath: //Organization/ Events/ FinancingEvents/ FinancingStatementFilingInformation/ DisclaimerText |
| Financing Statement Collateral Class | A further clarification of the scope of the collateral associated with a secured business transaction performed under the rules of the Uniform Commercial Code. PCM XPath: //Organization/ Events/ FinancingEvents/ FinancingStatementFilingInformation/ FinancialStatementFiling/ CollateralDetail/ CollateralClassText |
| Financing Statement Collateral Code | A code value for the type of collateral item. PCM XPath: //Organization/ Events/ FinancingEvents/ FinancingStatementFilingInformation/ FinancialStatementFiling/ CollateralDetail/ CollateralTypeText |
| Financing Statement Collateral Supplement Item | A further clarification of the scope of the collateral associated with a secured business transaction performed under the rules of the Uniform Commercial Code. PCM XPath: //Organization/ Events/ FinancingEvents/ FinancingStatementFilingInformation/ FinancialStatementFiling/ CollateralDetail/ CollateralSupplementalItemTypeText |
| Financing Statement Collateral Type Description | Text that describes a type of collateral item in a financing statement. PCM XPath: //Organization/ Events/ FinancingEvents/ FinancingStatementFilingInformation/ FinancialStatementFiling/ CollateralDetail/ CollateralTypeDescription |
| Financing Statement Comment Business Name | Text recording the name of a business which is the source of a comment about a financing statement. PCM XPath: //Organization/ Events/ FinancingEvents/ FinancingStatementFilingInformation/ FinancialStatementFiling/ ContactEvent/ ContactOrganizationName |
| Financing Statement Comment Date | The date by which the comment concerning the financing statement was made. PCM XPath: //Organization/ Events/ FinancingEvents/ FinancingStatementFilingInformation/ FinancialStatementFiling/ ContactEvent/ ContactDate |
| Financing Statement Comment Individual Name | Text recording the name of the individual from whom a financing statement comment was obtained. PCM XPath: //Organization/ Events/ FinancingEvents/ FinancingStatementFilingInformation/ FinancialStatementFiling/ ContactEvent/ ContactName/ FullName |
| Financing Statement Comment Job Description | Text recording the Position as preferred by the person with whom Dun & Bradstreet had contact to get information on this legal event. Applicable when the title provided is not included in D&B's list of principal positions. PCM XPath: //Organization/ Events/ FinancingEvents/ FinancingStatementFilingInformation/ FinancialStatementFiling/ ContactEvent/ ContactJobTitle |
| Financing Statement Comment Job Title | Text recording the title of an individual who has made a comment to D&B. PCM XPath: //Organization/ Events/ FinancingEvents/ FinancingStatementFilingInformation/ FinancialStatementFiling/ ContactEvent/ ContactPositionText |
| Financing Statement Comment Text | The text of the financing statement comment, which may be verbatim or summarized by Dun & Bradstreet. PCM XPath: //Organization/ Events/ FinancingEvents/ FinancingStatementFilingInformation/ FinancialStatementFiling/ ContactEvent/ ContactEventText/ Text |
| Financing Statement Comment Type | Text that describes the financing statement comment, which may be verbatim or summarized by Dun & Bradstreet. Can repeat up to two times. PCM XPath: //Organization/ Events/ FinancingEvents/ FinancingStatementFilingInformation/ FinancialStatementFiling/ ContactEvent/ ContactEventText/ Text |
| Financing Statement Contract Type | Text recording the type of contractual agreement which has been made between the secured party and debtor in a financing statement (e.g. Lease, rental, sale, refinance). PCM XPath: //Organization/ Events/ FinancingEvents/ FinancingStatementFilingInformation/ FinancialStatementFiling/ ContractTypeText |
| Financing Statement Date | The date when the financing statement was filed with the recording office or court. PCM XPath: //Organization/ Events/ FinancingEvents/ FinancingStatementFilingInformation/ FinancialStatementFiling/ FilingDate |
| Financing Statement Debtor Country Code | A country where a financing statement debtor is located, as stated on the filing document. PCM XPath: //Organization/ Events/ FinancingEvents/ FinancingStatementFilingInformation/ FinancialStatementFiling/ RolePlayer/ RolePlayerLocation/ CountryISOAlpha2Code |
| Financing Statement Debtor Name | Text recording the name of a debtor within the financing statement, as identified on the filing document. PCM XPath: //Organization/ Events/ FinancingEvents/ FinancingStatementFilingInformation/ FinancialStatementFiling/ RolePlayer/ RolePlayerName |
| Financing Statement Debtor Postal Code | An identifier used by the local country Postal Authority to identify the postal code of the location of the filing debtor as stated on the filing document. PCM XPath: //Organization/ Events/ FinancingEvents/ FinancingStatementFilingInformation/ FinancialStatementFiling/ RolePlayer/ RolePlayerLocation/ PostalCode |
| Financing Statement Debtor Street Address | Text recording the address number, or post office box number, and street name where the financing statement debtor is located, as stated on the filing document. PCM XPath: //Organization/ Events/ FinancingEvents/ FinancingStatementFilingInformation/ FinancialStatementFiling/ RolePlayer/ RolePlayerLocation/ StreetAddressLine/ LineText |
| Financing Statement Debtor Territory (Outside US) Name | Text recording the state, county or province outside of the US where the financing statement debtor is located, as indicated on the filing document. PCM XPath: //Organization/ Events/ FinancingEvents/ FinancingStatementFilingInformation/ FinancialStatementFiling/ RolePlayer/ RolePlayerLocation/ TerritoryName |
| Financing Statement Debtor 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 financing statement debtor is physically located. PCM XPath: //Organization/ Events/ FinancingEvents/ FinancingStatementFilingInformation/ FinancialStatementFiling/ RolePlayer/ RolePlayerLocation/ TerritoryAbbreviatedName |
| Financing Statement Debtor Town Name | Text recording the name of a city, town, township, village, borough, etc. where the financing statement debtor is located, as stated on the filing document. PCM XPath: //Organization/ Events/ FinancingEvents/ FinancingStatementFilingInformation/ FinancialStatementFiling/ RolePlayer/ RolePlayerLocation/ PrimaryTownName |
| Financing Statement Expiration Date | The date by which the effective period of a financing statement expires. PCM XPath: //Organization/ Events/ FinancingEvents/ FinancingStatementFilingInformation/ FinancialStatementFiling/ FilingExpirationDate |
| Financing Statement Filing Office Postal Code | An identifier used by the local country Postal Authority to identify the location of the court or filing office in which the financing statement was filed. PCM XPath: //Organization/ Events/ FinancingEvents/ FinancingStatementFilingInformation/ FinancialStatementFiling/ RolePlayer/ RolePlayerLocation/ PostalCode |
| Financing Statement Filing Office Street Address | Text recording the address number, or post office box number, and street name where the filing office or court which recorded the financing statement is located. PCM XPath: //Organization/ Events/ FinancingEvents/ FinancingStatementFilingInformation/ FinancialStatementFiling/ RolePlayer/ RolePlayerLocation/ StreetAddressLine/ LineText |
| Financing Statement Filing Office 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 financing statement registration filing office is physically located. PCM XPath: //Organization/ Events/ FinancingEvents/ FinancingStatementFilingInformation/ FinancialStatementFiling/ RolePlayer/ RolePlayerLocation/ TerritoryAbbreviatedName |
| Financing Statement Filing Office Territory Name | Text recording the name of the locally governed area which forms part of a centrally governed nation to identify where the financing statement was filed, is located. PCM XPath: //Organization/ Events/ FinancingEvents/ FinancingStatementFilingInformation/ FinancialStatementFiling/ RolePlayer/ RolePlayerLocation/ TerritoryName |
| Financing Statement Filing Office Town Name | Text recording the name of a city, town, township, village, borough, etc. where the filing office or court which recorded the financing statement is located. PCM XPath: //Organization/ Events/ FinancingEvents/ FinancingStatementFilingInformation/ FinancialStatementFiling/ RolePlayer/ RolePlayerLocation/ PrimaryTownName |
| Financing Statement Filings Counts | The number of financing statement filings for the business. PCM XPath: //Organization/ Events/ FinancingEvents/ FinancingStatementFilingInformation/ FinancialStatementFilingSummary/ TotalFilingCount |
| Financing Statement Office Name | Text recording the name of the filing office or court which recorded the financing statement. PCM XPath: //Organization/ Events/ FinancingEvents/ FinancingStatementFilingInformation/ FinancialStatementFiling/ RolePlayer/ RolePlayerName |
| Financing Statement Page Quantity | The number of pages that make up the financing statement filed with the filing office. PCM XPath: //Organization/ Events/ FinancingEvents/ FinancingStatementFilingInformation/ FinancialStatementFiling/ FilingPageQuantity |
| Financing Statement Received Date | The date by which the financing statement was received by D&B. PCM XPath: //Organization/ Events/ FinancingEvents/ FinancingStatementFilingInformation/ FinancialStatementFiling/ ReceivedDate |
| Financing Statement Reference Number | The identifying number assigned by the recording office or court to the financing statement. PCM XPath: //Organization/ Events/ FinancingEvents/ FinancingStatementFilingInformation/ FinancialStatementFiling/ FilingReferenceNumber |
| Financing Statement Secured Party Abbreviated Territory Name | Text recording the shortened name of the locally governed area which forms part of a centrally governed nation to identify where the financing statement secured party is physically located. PCM XPath: //Organization/ Events/ FinancingEvents/ FinancingStatementFilingInformation/ FinancialStatementFiling/ RolePlayer/ RolePlayerLocation/ TerritoryAbbreviatedName |
| Financing Statement Secured Party Country Code | A country where a secured party is located, as stated on the filing document. PCM XPath: //Organization/ Events/ FinancingEvents/ FinancingStatementFilingInformation/ FinancialStatementFiling/ RolePlayer/ RolePlayerLocation/ CountryISOAlpha2Code |
| Financing Statement Secured Party Name | Text recording the name of a secured party within a financing statement, as stated on the filing document. PCM XPath: //Organization/ Events/ FinancingEvents/ FinancingStatementFilingInformation/ FinancialStatementFiling/ RolePlayer/ RolePlayerName |
| Financing Statement Secured Party Postal Code | An identifier used by the local country Postal Authority to identify the postal code of the location of the secured party as stated on the filing document. PCM XPath: //Organization/ Events/ FinancingEvents/ FinancingStatementFilingInformation/ FinancialStatementFiling/ RolePlayer/ RolePlayerLocation/ PostalCode |
| Financing Statement Secured Party Street Address | Text recording the address number, or post office box number, and street name where the financing statement secured party is located, as stated on the filing document. PCM XPath: //Organization/ Events/ FinancingEvents/ FinancingStatementFilingInformation/ FinancialStatementFiling/ RolePlayer/ RolePlayerLocation/ StreetAddressLine/ LineText |
| Financing Statement Secured Party Territory (Outside US) Name | Text recording the state, county or province outside of the US where the secured party is located, as stated on the filing document. PCM XPath: //Organization/ Events/ FinancingEvents/ FinancingStatementFilingInformation/ FinancialStatementFiling/ RolePlayer/ RolePlayerLocation/ TerritoryName |
| Financing Statement Secured Party Town Name | Text recording the name of a city, town, township, village, borough, etc. where the financing statement secured party is located, as stated on the filing document. PCM XPath: //Organization/ Events/ FinancingEvents/ FinancingStatementFilingInformation/ FinancialStatementFiling/ RolePlayer/ RolePlayerLocation/ PrimaryTownName |
| Financing Statement Signer Job Description | Text recording the position held by the individual who signed a financial statement. Applicable when the title provided is not included in D&B's list of principal positions. PCM XPath: //Organization/ Events/ FinancingEvents/ FinancingStatementFilingInformation/ FinancialStatementFiling/ RolePlayer/ RolePlayerJobTitle/ JobTitleText |
| Financing Statement Signer Job Title | Text recording the job position the principal or manager holds or has held in the organization e.g. Financial Director Managing Director Sales Director Operations Manager. PCM XPath: //Organization/ Events/ FinancingEvents/ FinancingStatementFilingInformation/ FinancialStatementFiling/ RolePlayer/ RolePlayerPosition/ PositionText |
| Financing Statement Signer Name | Text recording the name of the individual signing a financing statement on behalf of a debtor business PCM XPath: //Organization/ Events/ FinancingEvents/ FinancingStatementFilingInformation/ FinancialStatementFiling/ RolePlayer/ RolePlayerName |
| Financing Statement Time | The time of day at which this financing agreement was filed under the US Uniform Commercial Code Act expressed in hours and minutes. PCM XPath: //Organization/ Events/ FinancingEvents/ FinancingStatementFilingInformation/ FinancialStatementFiling/ FilingTime |
| Financing Statement Type | The type of financing statement (e.g., original, release). PCM XPath: //Organization/ Events/ FinancingEvents/ FinancingStatementFilingInformation/ FinancialStatementFiling/ FilingTypeText |
| Financing Statement Verification Date | The date on which the reported content of the financing statement was verified by Dun & Bradstreet personnel. PCM XPath: //Organization/ Events/ FinancingEvents/ FinancingStatementFilingInformation/ FinancialStatementFiling/ VerifiedDate |
| Last Update Date | The date when the record was last updated in D&B's system. PCM XPath: //Organization/ SubjectHeader/ LastUpdateDate |
| Public Filing Disclaimer Text | Text that records static statement regarding the Public Filing information D&B is providing in a product. PCM XPath: //Organization/ Events/ PublicFilingHeader/ DisclaimerText |
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
This product returns up to the ten most recent UCC filings obtained by U. S. organizations.
Uniform Commercial Code (UCC) Filings are records often used to understand which businesses have a secured financial agreement with a given financial institution. The UCC law is intended to standardize and provide a "uniform" set of rules to govern commercial transactions which are often conducted across state lines.
The data for this product is obtained from central filing locations and through third parties and contract collectors at the state level. Actual document copies are received for nearly all locations and automated index information from more than two thirds of the states. In Georgia and Louisiana filings are performed at the county/parish level and then aggregated to the state level.
- © Dun & Bradstreet, Inc. 2019 – 2024. All rights reserved.