Data Products: Analytics

The samples provided are representative of what may be returned in responses. In order to provide comprehensive samples, some values were added where the actual response had null or no values.

In addition, values in both requests and responses have been "faked" or modified to protect potentially private data (e.g., phone number) where applicable. Therefore, using requests exactly as is may not return any results.

Contents

Request

GET https://plus.dnb.com/v1/data/duns/804735132?productId=aasbig&versionId=v1&tradeUp=hq&customerReference=customer%20reference%20text
Authorization: Bearer MyToken

Note: The same request structure applies for all data APIs. Change the product ID to request a different API.


Response

aasbig

{
  "transactionDetail": {
    "transactionID": "rrt-ec0304fa-d-ea-25767-5819335-1_363",
    "transactionTimestamp": "2017-05-17T20:31:08.469Z",
    "inLanguage": "en-US",
    "productID": "aasbig",
    "productVersion": "1"
  },
  "inquiryDetail": {
    "duns": "919191919",
    "productID": "aasbig",
    "productVersion": "v1"
    "tradeUp": "hq"
    "customerReference": "BILLING CUSTOMER"
  },
  "organization": {
    "duns": "919191919",
    "dunsControlStatus": {
      "isMarketable": true
    },
    "primaryName": "World Wide Travel Services, Inc.",
    "primaryAddress": {
      "language": {
        "description": "English",
        "dnbCode": 39
      },
      "addressCountry": {
        "name": "United States",
        "isoAlpha2Code": "US"
      },
      "continentalRegion": {
        "name": "North America"
      },
      "addressLocality": {
        "name": "PHOENIX"
      },
      "minorTownName": null,
      "addressRegion": {
        "name": "Arizona",
        "abbreviatedName": "AZ"
      },
      "addressCounty": {
        "name": "MARICOPA"
      },
      "postalCode": "850273840",
      "postalCodePosition": {
        "description": "Post code presented after Town/City name",
        "dnbCode": 1011
      },
      "streetNumber": "3151",
      "streetName": "W BEHREND DR",
      "streetAddress": {
        "line1": "3151 W BEHREND DR",
        "line2": "Suite 501"
      },
      "postOfficeBox": {
        "postOfficeBoxNumber": "12345",
        "typeDescription": "Post Office Box (Supplied by public Post Office authority.)",
        "typeDnBCode": 120
      }
    },
    "isStandalone": false,
    "corporateLinkage": {
      "familytreeRolesPlayed": [
        {
          "description": "Global Ultimate",
          "dnbCode": 12775
        },
        {
          "description": "Domestic Ultimate",
          "dnbCode": 12774
        },
        {
          "description": "Parent/Headquarters",
          "dnbCode": 9141
        }
      ],
      "hierarchyLevel": 1,
      "globalUltimateFamilyTreeMembersCount": 1669
    },
    "dnbAssessment": {
      "itBuydex": {
        "scoreDate": "2017-04-21",
        "rawScore": 98
      }
    }
  }
}

aasdhq

{
  "transactionDetail": {
    "transactionID": "rrt-0161ac151f08e125f-c-ea-24447-7296301-1_369",
    "transactionTimestamp": "2017-06-08T15:47:25.287Z",
    "inLanguage": "en-US",
    "productID": "aasdhq",
    "productVersion": "1"
  },
  "inquiryDetail": {
    "duns": "919191919",
    "productID": "aasdhq",
    "productVersion": "v1"
    "tradeUp": "hq"
    "customerReference": "BILLING CUSTOMER"
  },
  "organization": {
    "duns": "919191919",
    "primaryName": "World Wide Travel Services, Inc.",
    "primaryAddress": {
      "language": {
        "description": "English",
        "dnbCode": 39
      },
      "addressCountry": {
        "name": "United States",
        "isoAlpha2Code": "US"
      },
      "continentalRegion": {
        "name": "North America"
      },
      "addressLocality": {
        "name": "PHOENIX"
      },
      "minorTownName": null,
      "addressRegion": {
        "name": "Arizona",
        "abbreviatedName": "AZ"
      },
      "addressCounty": {
        "name": "MARICOPA"
      },
      "postalCode": "850273840",
      "postalCodePosition": {
        "description": "Post code presented after Town/City name",
        "dnbCode": 1011
      },
      "streetNumber": "3151",
      "streetName": "W BEHREND DR",
      "streetAddress": {
        "line1": "3151 W BEHREND DR",
        "line2": "Suite 501"
      },
      "postOfficeBox": {
        "postOfficeBoxNumber": "12345",
        "typeDescription": "Post Office Box (Supplied by public Post Office authority.)",
        "typeDnBCode": 120
      }
    },
    "isStandalone": false,
    "dnbAssessment": {
      "decisionPowerScore": 28.3,
      "isDecisionHeadQuarter": true,
      "decisionHeadQuarter": {
        "duns": "919191919",
        "decisionPowerScore": 28.3,
        "hierarchyLevel": 0,
        "primaryName": "World Wide Travel Services, Inc.",
        "primaryAddress": {
          "addressCountry": {
            "name": "United States",
            "isoAlpha2Code": "US"
          },
          "continentalRegion": {
            "name": "North America"
          },
          "addressLocality": {
            "name": "PHOENIX"
          },
          "addressRegion": {
            "name": "Arizona",
            "abbreviatedName": "AZ"
          },
          "postalCode": "850273840",
          "streetAddress": {
            "line1": "3151 W BEHREND DR",
            "line2": "Suite 501"
          }
        }
      }
    },
    "corporateLinkage": {
      "familytreeRolesPlayed": [
        {
          "description": "Global Ultimate",
          "dnbCode": 12775
        },
        {
          "description": "Domestic Ultimate",
          "dnbCode": 12774
        },
        {
          "description": "Parent/Headquarters",
          "dnbCode": 9141
        }
      ],
      "hierarchyLevel": 1,
      "globalUltimateFamilyTreeMembersCount": 1669,
      "globalUltimate": {
        "duns": "919191919",
        "primaryName": "World Wide Travel Services, Inc.",
        "primaryAddress": {
          "addressCountry": {
            "name": "United States",
            "isoAlpha2Code": "US"
          },
          "continentalRegion": {
            "name": "North America"
          },
          "addressLocality": {
            "name": "PHOENIX"
          },
          "addressRegion": {
            "name": "Arizona",
            "abbreviatedName": "AZ"
          },
          "postalCode": "850273840",
          "streetAddress": {
            "line1": "3151 W BEHREND DR",
            "line2": "Suite 501"
          },
          "domesticUltimate": {
            "duns": "919191919",
            "primaryName": "World Wide Travel Services, Inc.",
            "primaryAddress": {
              "addressCountry": {
                "name": "United States",
                "isoAlpha2Code": "US"
              },
              "continentalRegion": {
                "name": "North America"
              },
              "addressLocality": {
                "name": "PHOENIX"
              },
              "addressRegion": {
                "name": "Arizona",
                "abbreviatedName": "AZ"
              },
              "postalCode": "850273840",
              "streetAddress": {
                "line1": "3151 W BEHREND DR",
                "line2": "Suite 501"
              },
              "parent": {},
              "headQuarter": {}
            }
          }
        }
      }
    }
  }
}

aasmcu

{
  "transactionDetail": {
    "transactionID": "rrt-705ef266-c-ea-5781-5851522-3_363",
    "transactionTimestamp": "2017-05-17T20:40:25.554Z",
    "inLanguage": "en-US",
    "productID": "aasmcu",
    "productVersion": "1"
  },
  "inquiryDetail": {
    "duns": "919191919",
    "productID": "aasmcu",
    "productVersion": "v1"
    "tradeUp": "hq"
    "customerReference": "BILLING CUSTOMER"
  },
  "organization": {
    "duns": "919191919",
    "dunsControlStatus": {
      "operatingStatus": {
        "description": "Active",
        "dnbCode": 9074
      }
    },
    "primaryName": "World Wide Travel Services, Inc.",
    "isStandalone": false,
    "primaryAddress": {
      "language": {
        "description": "English",
        "dnbCode": 39
      },
      "addressCountry": {
        "name": "United States",
        "isoAlpha2Code": "US"
      },
      "continentalRegion": {
        "name": "North America"
      },
      "addressLocality": {
        "name": "PHOENIX"
      },
      "minorTownName": null,
      "addressRegion": {
        "name": "Arizona",
        "abbreviatedName": "AZ"
      },
      "addressCounty": {
        "name": "MARICOPA"
      },
      "postalCode": "850273840",
      "postalCodePosition": {
        "description": "Post code presented after Town/City name",
        "dnbCode": 1011
      },
      "streetNumber": "3151",
      "streetName": "W BEHREND DR",
      "streetAddress": {
        "line1": "3151 W BEHREND DR",
        "line2": "Suite 501"
      },
      "postOfficeBox": {
        "postOfficeBoxNumber": "12345",
        "typeDescription": "Post Office Box (Supplied by public Post Office authority.)",
        "typeDnBCode": 120
      }
    },
    "corporateLinkage": {
      "familytreeRolesPlayed": [
        {
          "description": "Global Ultimate",
          "dnbCode": 12775
        },
        {
          "description": "Domestic Ultimate",
          "dnbCode": 12774
        },
        {
          "description": "Parent/Headquarters",
          "dnbCode": 9141
        }
      ],
      "hierarchyLevel": 1,
      "globalUltimateFamilyTreeMembersCount": 1669
    },
    "dnbAssessment": {
      "materialChange": {
        "riskSegment": {
          "description": "Higher than Average Probabilityof Improvement in Risk Profile",
          "dnbCode": 30683
        },
        "organizationSizeSegment": {
          "description": "Business Profile Decay",
          "dnbCode": 30671
        },
        "borrowingSegment": {
          "description": "Business Profile Decay",
          "dnbCode": 30671
        },
        "spendSegment": {
          "description": "Business Profile Stable",
          "dnbCode": 30670
        },
        "opportunityFinalSegment": {
          "description": "Decrease In Scale",
          "dnbCode": 30680
        }
      },
      "triplePlay": {
        "compositeRiskScore": 8,
        "riskSegment": {
          "description": "Proceed with Caution",
          "dnbCode": 30665
        }
      }
    }
  }
}

aassem

{
    "transactionDetail": {
        "transactionID": "rrt-05bad8ff0c9600a27-d-ea-18901-79712706-2_490",
        "transactionTimestamp": "2018-09-27T15:29:06.283Z",
        "inLanguage": "en-US",
        "productID": "aassem",
        "productVersion": "1"
    },
    "inquiryDetail": {
        "productVersion": "v1",
        "productID": "aassem",
        "duns": "804735132"
    },
    "organization": {
        "duns": "804735132",
       "dunsControlStatus": {
            "operatingStatus": {
                "description": "Active",
                "dnbCode": 9074
            },
            "isMarketable": true,
            "isMailUndeliverable": false,
            "isTelephoneDisconnected": false,
            "isDelisted": false,
            "subjectHandlingDetails":  [
		        {
		          "description": "Do not fax",
		          "dnbCode": 7972
		        },
		        {
		          "description": "Do not send information requests",
		          "dnbCode": 7821
		        }
		      ],
            "fullReportDate": "2018-05-31"
        },
        "primaryName": "Gorman Manufacturing Company, Inc.",
        "primaryAddress": {
            "language": {
		        "description": "English",
		        "dnbCode": 39
		    },
            "addressCountry": {
                "name": "United States",
                "isoAlpha2Code": "US"
            },
            "continentalRegion": {
                "name": "North America"
            },
            "addressLocality": {
                "name": "SAN FRANCISCO"
            },
            "minorTownName": "SAN FRANCISCO",
            "addressRegion": {
                "name": "California",
                "abbreviatedName": "CA"
            },
            "addressCounty": {
                "name": "SAN FRANCISCO"
            },
            "postalCode": "94110",
            "postalCodePosition": {
		        "description": "Post code presented after Town/City name",
		        "dnbCode": 1011
		    },
            "streetNumber": "492",
            "streetName": "KOLLER ST",
            "streetAddress": {
                "line1": "492 KOLLER ST",
                "line2": null
            },
            "postOfficeBox": {
		        "postOfficeBoxNumber": "12345",
		        "typeDescription": "Post Office Box (Supplied by public Post Office authority.)",
		        "typeDnBCode": 120
		    },
            "latitude": 37.777709,
            "longitude": -122.404624,
            "geographicalPrecision": {
                "description": "Street Segment Centroid",
                "dnbCode": 30256
            },
            "isRegisteredAddress": false,
            "locationOwnership": {
		        "description": "Rents",
		        "dnbCode": 1129
		    },
            "congressionalDistricts": [
                {
                    "district": "12"
                }
            ],
            "isResidentialAddress": "true"
        },
        "dnbAssessment": {
            "assignmentModel": {
                "isStandalone": false,
                "familytreeRolesPlayed": [
		          {
		            "description": "Global Ultimate",
		            "dnbCode": 12775
		          },
		          {
		            "description": "Domestic Ultimate",
		            "dnbCode": 12774
		          },
		          {
		            "description": "Parent/Headquarters",
		            "dnbCode": 9141
		          }
		        ],
                "employeeReliability": {
                    "description": "Assigned",
                    "dnbCode": 33392
                },
                "salesReliability": {
                    "description": "Assigned",
                    "dnbCode": 33392
                },
                "hasChangeInGlobalUltimate": false,
                "physicalLocation": {
                    "employeeCount": 82,
                    "salesAmount": 10560418
                },
                "linkedCompanies": {
                    "employeeCount": 153,
                    "salesAmount": 24662580
                },
                "countryGroup": {
                    "employeeCount": 82,
                    "salesAmount": 10560418
                },
                "globalUltimate": {
                    "duns": "804735132",
                    "employeeCount": 153,
                    "salesAmount": 24662580,
                    "familyTreeMembersCount": 7,
                    "industrySectorsCount": 6,
                    "primarySector": {
                        "industryCode": "275",
                        "industryDescription": "Commercial printing",
                        "typeDnBCode": 23406,
                        "typeDescription": "US Standard Industry Code 1987 - 3 digit",
                        "sectorPercentage": 36.8
                    },
                    "secondarySector": {
                        "industryCode": "513",
                        "industryDescription": "Apparel, piece goods and notions",
                        "typeDnBCode": 23406,
                        "typeDescription": "US Standard Industry Code 1987 - 3 digit",
                        "sectorPercentage": 30.75
                    },
                    "unclassifiedSector": {
                    	"sectorPercentage": 43
                    }
                },
                "domesticUltimate": {
                    "duns": "804735132",
                    "employeeCount": 82,
                    "salesAmount": 10560418,
                    "familyTreeMembersCount": 1,
                    "industrySectorsCount": 1,
                    "primarySector": {
                        "industryCode": "275",
                        "industryDescription": "Commercial printing",
                        "typeDnBCode": 23406,
                        "typeDescription": "US Standard Industry Code 1987 - 3 digit",
                        "sectorPercentage": 100
                    },
                    "secondarySector": {
                        "industryCode": " ",
                        "industryDescription": null,
                        "typeDnBCode": 23406,
                        "typeDescription": "US Standard Industry Code 1987 - 3 digit",
                        "sectorPercentage": null
                    },
                    "unclassifiedSector":  {
                    	"sectorPercentage": 43
                    }
                }
            }
        },
        "financials": [
            {
                "financialStatementToDate": "2017-12-31",
                "financialStatementDuration": "Annual",
                "informationScopeDescription": "Consolidated",
                "informationScopeDnBCode": 9067,
                "reliabilityDescription": "Actual",
                "reliabilityDnBCode": 9092,
                "unitCode": "Single Units",
                "yearlyRevenue": [
                    {
                        "value": 24662580,
                        "currency": "USD"
                    }
                ]
            }
        ],
        "numberOfEmployees": [
            {
                "value": 120,
                "informationScopeDescription": "Headquarters Only (Employs Here)",
                "informationScopeDnBCode": 9068,
                "reliabilityDescription": "Actual",
                "reliabilityDnBCode": 9092,
                "employeeCategories": [
                    {
                        "employmentBasisDescription": "Principals",
                        "employmentBasisDnBCode": 9064
                    }
                ]
            },
            {
                "value": 153,
                "informationScopeDescription": "Consolidated",
                "informationScopeDnBCode": 9067,
                "reliabilityDescription": "Actual",
                "reliabilityDnBCode": 9092,
                "employeeCategories": [
                    {
                        "employmentBasisDescription": "Principals",
                        "employmentBasisDnBCode": 9064
                    }
                ]
            }
        ]
    }
}

Custom Analytics

Request

GET https://plus.dnb.com/v1/customScore/duns/804735132?productId=aascs1&versionId=v1&customerReference=customer%20reference%20text
Authorization: Bearer MyToken

Response

{
    "transactionDetail": {
        "transactionID": "rrt-00caab27add6566ae-c-ea-27250-277810272-4",
        "transactionTimestamp": "2019-09-18T16:51:01.734Z",
        "inLanguage": "en-US",
        "productID": "aascs1",
        "productVersion": "v1"
    },
    "inquiryDetail": {
        "duns": "804735132",
        "productID": "aascs1",
        "versionId": "v1"
    },
    "organization": {
        "duns": "804735132",
        "countryISOAlpha2Code": "US",
        "primaryName": "Gorman Manufacturing Company, Inc.",
        "primaryAddress": {
            "addressCountry": {
                "name": "United States",
                "isoAlpha2Code": "US"
            },
            "continentalRegion": {
                "name": "North America"
            },
            "addressLocality": {
                "name": "San Francisco"
            },
            "minorTownName": null,
            "addressRegion": {
                "name": "California",
                "abbreviatedName": "CA"
            },
            "addressCounty": {
                "name": "San Francisco"
            },
            "postalCode": "94110",
            "streetName": null,
            "streetNumber": null,
            "streetAddress": {
                "line1": "492 Koller St",
                "line2": null,
                "line3": null,
                "line4": null
            },
            "postOfficeBox": {}
        },
        "customScore": {
            "scoreModel": "AASCS1",
            "rawScore": 508,
            "classScore": null,
            "riskSegment": null,
            "scorePercentile": null,
            "scoreReasons": [
                {
                    "dnbCode": 30234,
                    "description": "Proportion of trade accounts that are past due"
                },
                {
                    "dnbCode": 33863,
                    "description": "Average proportion of owed amount that is more than 60 days past due from the past 3 months"
                },
                {
                    "dnbCode": 33862,
                    "description": "Average of the Paydex scores from the past 12 months"
                },
                {
                    "dnbCode": 33864,
                    "description": "Current 12 month Detailed Trade Paydex score"
                }
            ],
            "recommendedCreditLimit": {}
        },
        "predictiveAttributes": [
            {
                "key": "dt_acct_pd_by_tot_acct_rcnt_pct",
                "value": 1
            },
            {
                "key": "pslow60p",
                "value": 4.117
            },
            {
                "key": "avgpdx12",
                "value": 69
            }
        ]
    }
}