Sign in

v1

latestOpenAPI 3.0.12026-07-243124341009.5 KB
Talent

Get a List of Talent Assessments

Retrieves assessment results for the specified talent.

get/v1/talent/{talentId}/assessments

Path parameters

talentIdstring required

The identifier for the talent whose assessments are being retrieved.

Headers

RequestIdstring uuid

The unique request identifier used to correlate request data with log entries and events, formatted as a UUID.

Unique request identifier (UUID) used to correlate request data with log entries and events.

FrontOfficeTenantIdinteger

An integer identifier for the tenant that the request is being made for. Required when Tenant header is not provided.

Tenantstring

Tenant company code that determines data access scope during the request. Required when FrontOfficeTenantId header is not provided.

Response

A list of talent assessment results for the specified talent.

applicantAssessmentIdinteger

The identifier for the assessment associated with a talent.

sessionStatusstring

The status of the assessment.

talentIdinteger

The identifier for the talent.

providerAssessmentIdstring guid

The provider identifier for the assessment.

providerAssessmentNamestring

The provider name for the assessment.

providerTypestring

The name of the provider.

completedDateTimestring date-time

The date and time when the assessment was completed. The field follows the YYYY-MM-DD or YYYY-MM-DDTHH:mm:ss formats and also supports fractional seconds, such as YYYY-MM-DDTHH:mm:ss.sss. For example, 2024-12-01, 2024-12-01T14:30:00, and 2024-12-01T14:30:00.546.

totalQuestionsinteger

The total number of questions within the specified assessment.

questionsCorrectinteger

The total number of questions answered correctly within the specified assessment.

displayScorestring

The display score of the specified assessment.

overallEvaluationTextstring

The overall evaluation text for the specified assessment.

overallScoreTypestring

The overall score type for the specified assessment.

overallNumericScoreinteger

The overall numeric score achieved by the talent in the specified assessment.

rawScorenumber double

The raw score obtained by the talent in the specified assessment.

tscorenumber double

The T-score obtained by the talent in the specified assessment.

zscorenumber double

The Z-score obtained by the talent in the specified assessment.

Example response

[
  {
    "applicantAssessmentId": 42280,
    "sessionStatus": "Completed",
    "talentId": 189482,
    "providerAssessmentId": "EDDD9D28-DE39-4563-88DC-1930D6C6F748",
    "providerAssessmentName": "Basic Spelling",
    "providerType": "SHL",
    "totalQuestions": 25,
    "questionsCorrect": 24,
    "displayScore": "87 %tile",
    "overallEvaluationText": "Pass",
    "overallScoreType": "Percentile",
    "overallNumericScore": 87,
    "rawScore": 87,
    "tscore": 49.993,
    "zscore": 0.584
  }
]