> For the complete documentation index, see [llms.txt](https://api-docs.roundhr.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://api-docs.roundhr.com/round-api/api-reference/feedback/candidate-scores-list.md).

# 지원자별 평가 목록

## 지원자별 평가 목록

<mark style="color:green;">`GET`</mark> `https://api.roundhr.com/v1/feedback/candidate_scores`

특정 지원자의 모든 평가 목록을 반환합니다.

**Headers**

| Name          | Value              |
| ------------- | ------------------ |
| Content-Type  | `application/json` |
| Authorization | `Bearer <token>`   |

**Query Parameters**

| Name          | Type   | 필수         | Description |
| ------------- | ------ | ---------- | ----------- |
| candidate\_id | string | `required` | 지원자 고유 코드   |

**응답 예제**

{% tabs %}
{% tab title="200" %}

```json
{
  "resources": [
    {
      "code": "code_score123",
      "status": "complete",
      "feedback_kind": "interview",
      "result": "A",
      "score": 85,
      "score_count": 3,
      "total_score_count": 3,
      "job_stage_title": "1차 면접",
      "created_at": "2024-09-02T18:56:37+09:00",
      "updated_at": "2024-09-05T10:30:00+09:00",
      "member_scores": [
        {
          "code": "code_member123",
          "status": "complete",
          "feedback_kind": "interview",
          "submit": true,
          "final_result": "A",
          "final_score": 90,
          "final_comment": "기술 역량이 뛰어남",
          "created_at": "2024-09-02T18:56:37+09:00",
          "updated_at": "2024-09-03T14:20:00+09:00",
          "user": {
            "code": "code_user123",
            "email": "interviewer1@example.com",
            "role": "admin",
            "name": "김면접",
            "phone": "010-1111-2222",
            "position": "개발팀장",
            "tutorial_step": 5,
            "tutorial_complete": true,
            "created_at": "2024-01-01T09:00:00+09:00",
            "updated_at": "2024-09-03T14:20:00+09:00"
          }
        },
        {
          "code": "code_member456",
          "status": "complete",
          "feedback_kind": "interview",
          "submit": true,
          "final_result": "B",
          "final_score": 80,
          "final_comment": "협업 능력 우수",
          "created_at": "2024-09-02T18:56:37+09:00",
          "updated_at": "2024-09-04T09:15:00+09:00",
          "user": {
            "code": "code_user456",
            "email": "interviewer2@example.com",
            "role": "manager",
            "name": "이평가",
            "phone": "010-3333-4444",
            "position": "시니어 개발자",
            "tutorial_step": 5,
            "tutorial_complete": true,
            "created_at": "2024-02-01T09:00:00+09:00",
            "updated_at": "2024-09-04T09:15:00+09:00"
          }
        }
      ]
    },
    {
      "code": "code_score456",
      "status": "ongoing",
      "feedback_kind": "review",
      "result": null,
      "score": null,
      "score_count": 1,
      "total_score_count": 2,
      "job_stage_title": "서류 검토",
      "created_at": "2024-09-01T10:00:00+09:00",
      "updated_at": "2024-09-01T15:30:00+09:00",
      "member_scores": [
        {
          "code": "code_member789",
          "status": "complete",
          "feedback_kind": "review",
          "submit": true,
          "final_result": "S",
          "final_score": 95,
          "final_comment": "경력 사항이 우수함",
          "created_at": "2024-09-01T10:00:00+09:00",
          "updated_at": "2024-09-01T15:30:00+09:00",
          "user": {
            "code": "code_user789",
            "email": "reviewer@example.com",
            "role": "manager",
            "name": "박서류",
            "phone": "010-5555-6666",
            "position": "HR 담당자",
            "tutorial_step": 5,
            "tutorial_complete": true,
            "created_at": "2024-01-15T09:00:00+09:00",
            "updated_at": "2024-09-01T15:30:00+09:00"
          }
        }
      ]
    }
  ]
}
```

{% endtab %}

{% tab title="400" %}

```json
{
  "error": "bad_request",
  "message": "candidate_id is required"
}
```

{% endtab %}

{% tab title="404" %}

```json
{
  "error": "not_found",
  "message": "Resource not found"
}
```

{% endtab %}
{% endtabs %}

**응답 필드 설명**

| Field               | Type    | Description                                     |
| ------------------- | ------- | ----------------------------------------------- |
| code                | string  | 평가 고유 코드                                        |
| status              | string  | 평가 상태 (ongoing, complete, expire)               |
| feedback\_kind      | string  | 평가 종류 (sourcing, review, assignment, interview) |
| result              | string  | 최종 평가 결과 (S, A, B, C, D 등)                      |
| score               | integer | 최종 평가 점수                                        |
| score\_count        | integer | 완료된 평가자 수                                       |
| total\_score\_count | integer | 전체 평가자 수                                        |
| job\_stage\_title   | string  | 채용 단계명                                          |
| member\_scores      | array   | 평가자별 평가 내역                                      |

**member\_scores 필드**

| Field          | Type    | Description               |
| -------------- | ------- | ------------------------- |
| code           | string  | 평가자 평가 고유 코드              |
| status         | string  | 평가 상태 (ongoing, complete) |
| feedback\_kind | string  | 평가 종류                     |
| submit         | boolean | 제출 여부                     |
| final\_result  | string  | 평가 결과                     |
| final\_score   | integer | 평가 점수                     |
| final\_comment | string  | 평가 코멘트                    |
| user           | object  | 평가자 정보                    |

**user 필드**

| Field              | Type    | Description |
| ------------------ | ------- | ----------- |
| code               | string  | 사용자 고유 코드   |
| email              | string  | 이메일         |
| role               | string  | 역할          |
| name               | string  | 이름          |
| phone              | string  | 전화번호        |
| position           | string  | 직책          |
| tutorial\_step     | integer | 튜토리얼 진행 단계  |
| tutorial\_complete | boolean | 튜토리얼 완료 여부  |