Assessment Results

As you will typically want to make comparisons between a number of candidates on the position, the Revelian API provides an aggregated view of assessment results and suitability for all candidates in a position.

Once invitations have been created you may poll periodically for results. Once a candidate has undertaken an assessment, polling will return results for the candidate’s sitting of the assessment. Prior to a candidate’s assessment results being available, polling will return an unpopulated result with an invitation indicating that the assessment is either INVITED or IN_PROGRESS.

Response

The results response provides a page of the candidates on the position, filtered if requested, with corresponding result details for each assessment undertaken by the candidate.

Each candidate returned in the response has candidate name, overall candidate report url, candidate suitability score, and a unique assessment result for each assessment that the candidate has been invited to.

Results are ordered by candidate suitability from highest to lowest.

Candidate Suitability

Candidate suitability is a weighted, aggregate result for a candidate across a number of assessments (filtered by assessment if requested). It is the recommended way to compare and rank multiple candidates within a Position.

We strongly recommend using the candidate suitability score as the most valid and accurate method of comparing candidates.

In the interests of fairness, you should obtain and compare candidate suitability scores for the same set of assessments for each candidate.

If a candidate has not been invited to, or hasn’t yet completed an assessment attached to a particular position, that candidate won’t have a suitability score.

Candidate Assessment Results

Depending on the assessment type, the results will have certain attributes populated and unpopulated.

Assessment Result Type

Different assessments vary in terms of the specific results available. These can include:

Report Only

A URL to a HTML page that provides the assessment report.

Report Only is the base result type. All assessments will have this detail as a minimum.

Scored

As well as a report URL the result will also contain a percentile score and classification.

Validated

As well as a report URL and score attributes, the report may also contain a validity status (this applies to the Work Safety Assessment (RWSA), Work Reliability Scale (RWRS) and Revelian Behavioural Profile (RBP)).

The candidate assessment result contains a type attribute which indicates the type of the assessment result. Integration logic can use this value to determine which result attributes are present.

Invitations

A set of associated invitations will be nested within each candidate assessment result. Typically, this will contain a single invitation; however if the candidate has been invited to complete a second verified sitting of the Revelian Cognitive Ability Test (RCAT) there will be two invitations: the first to complete the assessment remotely, and the second for the supervised sitting.

Each invitation will provide a status which can be used to determine what state the sitting of the assessment is at by the candidate. This status can be used to determine subsequent actions/flows, for example, re-inviting a candidate to an expired assessment if the status were EXPIRED.

Examples

An example of a candidate assessment result for a remote sitting of an assessment where the candidate has completed the assessment

...
  "results": [
    {
      "assessment": "{AssessmentId}",
      "type": "SCORED",
      "reportUrl": "{CandidateAssessmentReportUrl}",
      "percentile": 92,
      "classification": "FAR_ABOVE_AVERAGE",
      "validity": null,
      "invitations": [
        {
          "id": "{RemoteInvitationId}",
          "expiry": "2016-03-06",
          "candidateLoginUrl": "{CandidateLoginUrl}",
          "type": "REMOTE",
          "status": "TESTED_WITH_RESULTS",
          "created": "2015-12-31T13:00:00Z",
          "completed": "2016-01-15T13:00:00Z"
        }
      ]
    }
  ]
...

An example of a a candidate assessment result for a verified sitting of an assessment where the candidate has completed the remote sitting of the assessment but has yet to undertake the supervised sitting of the assessment

...
  "results": [
    {
      "assessment": "{AssessmentId}",
      "type": "SCORED",
      "reportUrl": "{CandidateAssessmentReportUrl}",
      "percentile": 92,
      "classification": "FAR_ABOVE_AVERAGE",
      "validity": null,
      "invitations": [
        {
          "id": "{RemoteInvitationId}",
          "expiry": "2016-03-06",
          "candidateLoginUrl": "{CandidateLoginUrl}",
          "type": "REMOTE",
          "status": "TESTED_WITH_RESULTS",
          "created": "2015-12-31T13:00:00Z",
          "completed": "2016-01-15T13:00:00Z"
        },
        {
          "id": "{SupervisedInvitationId}",
          "expiry": "2016-03-06",
          "candidateLoginUrl": "{CandidateLoginUrl}",
          "type": "SUPERVISED",
          "status": "INVITED",
          "created": "2016-01-31T13:00:00Z",
          "completed": null
        }
      ]
    }
  ]
...

Note that the result of the remote sitting is considered to be the assessment result until the candidate undertakes the supervised sitting, at which time the result may, or may not, be adjusted. See verified scores for details of verified assessment scoring.

Filtering

The position results can, optionally, be filtered by a set of candidate identifiers; a set of assessment identifiers; or a combination of the two. If no filters are provided the results returned will be for all candidates and all assessments configured for the position.

Examples

An example of a Position Result request that filters the response to only provide results for two candidates

GET https://{BASE_URL}/positions/{PositionId}/results?candidate={CandidateId1}&candidate={CandidateId2}

An example of a Position Result request that filters the response to only provide results for two assessments

GET https://{BASE_URL}/positions/{PositionId}/results?assessment={AssessmentId1}&assessment={AssessmentId2}

An example of a Position Result request that filters the response to only provide results for a single candidate for two assessments

GET https://{BASE_URL}/positions/{PositionId}/results?candidate={CandidateId1}&assessment={AssessmentId1}&assessment={AssessmentId2}