> 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/form-submissions/list.md).

# 폼 제출 목록 조회

<mark style="color:green;">`GET`</mark> `https://api.roundhr.com/v1/candidates/{candidate_code}/form_submissions`

지원자의 폼 제출 목록을 반환합니다. Cursor Pagination을 지원합니다.

**Headers**

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

**Path Parameters**

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

**Query Parameters**

| Name        | Type    | 필수         | Description                 |
| ----------- | ------- | ---------- | --------------------------- |
| per         | integer | `optional` | 페이지당 항목 수 (기본: 20, 최대: 100) |
| page\_token | string  | `optional` | 페이지네이션 토큰                   |

**응답 예제**

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

```json
{
  "collection": [
    {
      "code": "code_abc123",
      "kind": "message",
      "form_title": "사전 질문",
      "form_description": "면접 전 사전 질문입니다.",
      "candidate_name": "김라운",
      "candidate_email": "test@example.com",
      "submitted_at": "2024-10-10T00:00:00+09:00",
      "created_at": "2024-10-10T00:00:00+09:00",
      "form_template": {
        "id": 1,
        "name": "사전 질문 템플릿"
      },
      "submission_answers": [
        {
          "id": 1,
          "kind": "text",
          "sub_kind": null,
          "order": 1,
          "title": "자기소개를 해주세요",
          "description": null,
          "accessible": true,
          "answer_json_info": {
            "value": "안녕하세요. 김라운입니다."
          },
          "question": {
            "id": 10,
            "kind": "text",
            "title": "자기소개를 해주세요",
            "required": true,
            "answer_options": []
          }
        }
      ]
    }
  ],
  "pagination": {
    "next_url": "https://api.roundhr.com/v1/candidates/w3NfSD7FsY/form_submissions?page_token=eyJpZCI6MTIzfQ_N",
    "prev_url": null,
    "total_count": 5
  }
}
```

{% endtab %}

{% tab title="404" %}

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

{% endtab %}
{% endtabs %}

***

## 응답 필드 설명

| Field               | Type   | Description                         |
| ------------------- | ------ | ----------------------------------- |
| code                | string | 폼 제출 고유 코드                          |
| kind                | string | 양식 종류 (message, reference\_check 등) |
| form\_title         | string | 양식 제목                               |
| form\_description   | string | 양식 설명                               |
| candidate\_name     | string | 지원자 이름                              |
| candidate\_email    | string | 지원자 이메일                             |
| submitted\_at       | string | 제출 일시                               |
| created\_at         | string | 생성 일시                               |
| form\_template      | object | 양식 템플릿 정보                           |
| submission\_answers | array  | 제출 답변 목록                            |

**form\_template 필드**

| Field | Type    | Description |
| ----- | ------- | ----------- |
| id    | integer | 템플릿 ID      |
| name  | string  | 템플릿 이름      |

**submission\_answers 필드**

| Field              | Type    | Description                   |
| ------------------ | ------- | ----------------------------- |
| id                 | integer | 답변 ID                         |
| kind               | string  | 질문 종류                         |
| sub\_kind          | string  | 세부 종류 (referrer, recipient 등) |
| order              | integer | 순서                            |
| title              | string  | 질문 제목                         |
| description        | string  | 질문 설명                         |
| accessible         | boolean | 현재 사용자의 접근 권한 여부              |
| answer\_json\_info | object  | 답변 데이터                        |
| question           | object  | 질문 원본 정보                      |

**answer\_json\_info 필드**

질문 종류(kind)에 따라 포함되는 필드가 다릅니다.

| Field   | Type    | Description                          |
| ------- | ------- | ------------------------------------ |
| value   | string  | 단일 답변 값 (text, textarea, dropdown 등) |
| values  | array   | 복수 답변 값 (checkbox, multi\_select 등)  |
| checked | boolean | 체크 여부 (agree 등)                      |
| links   | array   | 첨부 파일 URL 목록 (file\_upload)          |
| name    | string  | 이름 (contact 정보)                      |
| email   | string  | 이메일 (contact 정보)                     |
| phone   | string  | 전화번호 (contact 정보)                    |

{% hint style="info" %}
각 필드는 해당 종류의 질문일 때만 값이 존재
{% endhint %}

**question 필드**

| Field           | Type    | Description |
| --------------- | ------- | ----------- |
| id              | integer | 질문 ID       |
| kind            | string  | 질문 종류       |
| title           | string  | 질문 제목       |
| required        | boolean | 필수 여부       |
| answer\_options | array   | 선택지 목록      |