Get Assessment Results

Data Attributes in the Get Assessment Results Payload: Unique Styles, Factors, Sub-Factors and Strongest Factor Calculations and Scores

 

The Get Assessment Results API is one of the core tools available within the DNA API suite, providing an efficient way to retrieve and store the results information for a participant. Given its extensive utility, it’s also one of the most widely used endpoints, especially valuable if you maintain a dedicated database for storing behavioral data on your end.

To ensure optimal performance, the API sends data in an abbreviated format. This streamlined approach minimizes payload size, enabling faster and more efficient data transfer. Below are the primary attributes included in the payload:

 

Name Description Notes
personID Unique identifier for the participant  
firstName Participant first name  
lastName Participant last name  
groupID Account ID  
creditID Credit ID associated with the discovery  
completionDate Date of discovery completion  
behaviorTypeID ID code associated with the unique style  More details are available in the spreadsheet below
languageID ID code associated with the Language  More details are available in the spreadsheet below
factorID5-36 T-scores for the Factors More details are available in the spreadsheet below
topTwoBehavioralFactors Top 2 Strongest Factors (in array) More details are available in the spreadsheet below
strongestTrait1 The Strongest Factor More details are available in the spreadsheet below
strongestTrait2 The Second Strongest Factor More details are available in the spreadsheet below

 

The payload for the Get Assessments Result API is abbreviated to improve the performance of the response. Download this guide (click here) for a complete listing of the IDs and details for this API response.

Example Response Payload:

{
"personID": "cb1e0dc6-47d6-481a-a503-bff77cbe90a7",
"firstName": "Ronnie",
"lastName": "Smith",
"groupID": 1215,
"creditID": 6486,
"completionDate": "2023-05-04T20:12:10.8586696",
"behaviorTypeID": 5,
"languageID": 22,
"factorID5": 51,
"factorID6": 52,
"factorID7": 49,
"factorID8": 45,
"factorID9": 50,
"factorID10": 51,
"factorID11": 62,
"factorID12": 42,
"factorID13": 54,
"factorID14": 38,
"factorID15": 48,
"factorID16": 49,
"factorID17": 50,
"factorID18": 53,
"factorID19": 51,
"factorID20": 43,
"factorID21": 56,
"factorID22": 50,
"factorID23": 40,
"factorID24": 46,
"factorID25": 39,
"factorID26": 56,
"factorID27": 47,
"factorID28": 56,
"factorID29": 61,
"factorID30": 45,
"factorID31": 44,
"factorID32": 70,
"factorID33": 54,
"factorID34": 41,
"factorID35": 48,
"factorID36": 49,
"topTwoBehavioralFactors": {
"strongestTrait1": {
"id": 11,
"tScore": 62
},
"strongestTrait2": {
"id": 112,
"tScore": 58
}
}
}