RESTful POST Candidate Scores

Dayforce RESTful Web Services Developer Guide

Version
R2025.2.1
ft:lastEdition
2025-12-01
RESTful POST Candidate Scores

The POST Candidate Scores endpoint is used to post candidate assessment scores to Dayforce when the candidate completes their assessment. The scores are displayed in candidate profiles in Recruiting.

The following is a sample response that Dayforce is expecting from providers:

{
    "CreationDateTime": "2019-11-20T11:12:52.8188554Z",
    "CandidateAssessmentGuid": "6015AA33-5E91-41DE-994A-0F4C7F8FED6F",
    "OverallScore": {
        "Score": "90",
        "ScoreType": "Percentile",
        "PassFailed": false
    },
    "IsRecommended": true,
    "RecommendationStatement": "This is a recommended statement",
    "DetailedScores": [
        {
            "ShortName": "C#",
            "Score": "80",
            "ScoreType": "Percentile",
            "PassFailed": true
        },
        {
            "ShortName": "SQL",
            "Score": "30",
            "ScoreType": "Percentile",
            "PassFailed": false
        }
    ]
   "Reports": [
     {
	 "ShortName": "sample report 1",
	 "ReportLink": "http://sample-report-url"
      }
   ]		
}
Response schema description
Parameters Description

CreationDateTime

Date the details were sent/received

CandidateAssessmentGuid*

Dayforce candidate assessment reference

OverallScore*

Information about the candidate's overall assessment score

Score*

Candidate assessment overall score

ScoreType

The score type (for example, percentile)

PassFailed

Has the candidate passed the assessment

IsRecommended

Is the candidate recommended

RecommendationStatement

Recommendation statement

DetailedScores

List of details candidate assessment scores

ShortName*

Name of the assessment

Score*

Candidate score for the assessment

ScoreType

The score type (for example, percentile)

PassFailed

Has the candidate passed the assessment

Reports*

List of candidate assessment reports

ShortName

Report name

ReportLink*

Report link

StatusInfo*

Information about the request status

Code*

Status of the request

Message

Additional message about any errors