Mini Research

Overview

Mini Research focuses on the assignment of DUNS Numbers to Business Entities validating basic firmographic details. Mini Research allows a customer to receive a new DUNS without a researcher reviewing all possible data points for an entity, thus reducing response time of the request.

Specifications

Use Case Required Elements Market applicability Next steps
Assign D-U-N-S Number when customer cannot find record for the business
  • Research Request Type = Mini
  • Business Name (Mandatory)
  • Street Address (Mandatory)
  • Address Locality (City) (Mandatory)
  • Country ISO Code (Mandatory)
Global
  • D-U-N-S Number created - Customers should use the new D-U-N-S number and basic firmographics details.
  • D-U-N-S Number already exists - Customers should use the existing D-U-N-S number and basic firmographics details provided in the response.
  • D-U-N-S Number could not be created - Customers should update his record that business does not exists. Customers may challenge the resolution by providing additional information.

Update firmographics detail of Business Entities when DUNS Number is available. Research request to be submitted with Research Request Type = Mini, along with Research SubType Code and its required elements as mentioned in the table below. Please refer below table for additional details.

Research Sub Type Research Sub Type Code Required Elements Market applicability Next steps
Primary Business Name 33550
  • DUNS Number
  • Business Name
Global
  • Data was changed or added - Customers should use the research results and update his records for the business.
  • Data was correct, so it was not changed - Customers should use the research results and update his records for the business.
  • Requested change could not be verified, so data was not changed - Customers should use the research results and update his records for the business.
TradeStyle Name 33766
  • DUNS Number
  • TradeStyle Name
Global
Address 33549
  • DUNS Number
  • Street Address
  • Address Locality (City)
  • Postal Code
  • Country ISO Code
Global
Chief Executive Officer 33552
  • DUNS Number
Global
Line of Business 33554
  • DUNS Number
Global
Telephone Number 33555
  • DUNS Number
Global
Legal Form 33538
  • DUNS Number
Global

Error Handling

Error Code Error Message Description
00004 You are not currently authorised to access this product. Please contact your D&B account representative This error may be returned if:
  • - Authorization header is missing or invalid.
  • - Access token is missing.
  • - Subscriber is not entitle to the requested API or feature.
05007 One or more mandatory parameters are missing A required parameter is missing in the API request.
10002 Invalid Parameters A required parameter is missing or a parameter value is missing. Please see the documentation for information on this parameter.
  • Potential issues:
  • - Required parameter not found.
  • - Invalid combination of fields entered.
10001 DUNS not found The D-U-N-S Number in the request was not found
10007 Request cannot be fulfilled for the given criteria Potential Issue: Research Type is not supported in the specified Country
0008 Malformed payload Please see the documentation for information on this parameter

Special Handling

  • Customer must provide orderReason while submitting researches on German companies.

JSON Samples

Sample Request and Response

Daily Limits

Each customer is limited to submit a daily limit of 25 researches per country with the following exceptions.

Country Daily Limit
Italy 5
Austria 15
Czech Republic /Slovakia 15
Denmark 20
Finland 15
Hungary 15
Norway 20
Poland 15
Sweden 5
Switzerland/Lichtenstein 15

Expected Response Time per Market

5 business days