Get 360-Degree Assessment Details

API Overview

• Function: Get 360-degree assessment details (Only supports 360-degree surveys)
• Request Method: GET
• Request URL: /api/surveys/{survey_id}/appraisals/result/{staff_id}/relations?appid={appid}&access_token={access_token}

Request Parameters

Parameter Name	Type	Location	Description	Example
survey_id	integer	uri	Survey ID	292192
staff_id	integer	uri	Assessee ID	1

Response Parameters

Parameter Name	Type	Description
[_].appraisal_user_id	integer	Assessor User ID
[_].appraiser_name	string	Assessor Name
[_].relation_name	string	Assessment Relationship
[_].result	integer	Final Score
[_].answer_id	integer	Assessment Response Number
[_].question_results	array[object]	Array of Question Scores
[_].question_results[_].question_id	string	Question ID
[_].question_results[_].result	string	Individual Question Score

Response Examples

{
    "code": "OK",
    "error": {
        "type": ""
    },
    "data": [
        {
            "id": 10110,
            "appraiser_id": 21084709,
            "appraisal_user_id": 500024100001,
            "appraiser_name": "User A",
            "relation_id": 1000,
            "relation_name": "Self Assessment",
            "relation_alias": "Self Assessment",
            "result": 5,
            "answer_id": 35,
            "question_results": [
                {
                    "question_id": "q-2-BJrH",
                    "result": 2.1
                },
                {
                    "question_id": "q-1-abcd",
                    "result": 3.5
                }
            ]
        },
        {
            "id": 10110,
            "appraiser_id": 21084705,
            "appraisal_user_id": 500024100002,
            "appraiser_name": "User B",
            "relation_id": 1002,
            "relation_name": "Self Assessment",
            "relation_alias": "Self Assessment",
            "result": 8,
            "answer_id": 30,
            "question_results": [
                {
                    "question_id": "q-2-BJrH",
                    "result": 3
                },
                {
                    "question_id": "q-1-abcd",
                    "result": 3.6
                }
            ]
        }
    ],
    "request_id": "iSO1bko6Dg2NNhnZ20240604172849"
}

• Failed Request

{
    "code": "InvalidArgument",
    "error": {
        "type": "invalid_argument",
    },
    "data": {},
    "request_id": "ddec96d2-165e-4f3e-8a64-2057db116d1s"
}

Error Codes

error.type Code	Description
claim_error	Permission Validation Error
invalid_argument	Parameter Validation Failed