# 전자서명 템플릿 목록 조회 API

현재 비즈니스에 등록된 전자서명 템플릿 목록을 확인할 수 있습니다.

<br>

## `GET` kit-api/v1/signature-templates

Method: GET\
Endpoint: kit-api/v1/signature-templates

<br>

## Example

```
...kit-api/v1/signature-templates?limit=10&offset=0
```

<br>

## Request Query

| Key            | Description                             | Required |
| -------------- | --------------------------------------- | -------- |
| limit          | 목록 개수 (default 10, max 100)             | no       |
| offset         | 스킵할 목록 개수                               | no       |
| title          | 전자서명 템플릿 이름으로 필터 (string)               | no       |
| tagIds         | 연결된 계약서 태그로 필터 (쉼표로 구분: ex. tagIds=2,3) | no       |
| signatureCount | 연결된 서명 개수도 함께 조회할지 여부 (true, false)     | no       |
| slug           | 템플릿의 slug 값으로 필터 (string)               | no       |

<br>

## Response

```json
{
  "ok": true, // api 성공 여부
  "message": undefined, // Error가 존재하면 message(string)로 전달
  "data": {
    "templates": [
      // 전자서명 템플릿 목록 (계약서의 파일은 계약서 상세 조회 API에서 조회할 수 있습니다.)
      {
        "id": 12345, // 고유 식별 id
        "name": "MOU 템플릿", // 전자서명 템플릿 이름
        "participantType": "TOGETHER", // 서명 타입 (순서대로 서명 여부 - TOGETHER, ORDER)
        "slug": "test_slug_03232", // slug(문자)
        "ccEmails": ["cc@prix.im"], // 워크플로우 이메일 참조자
        "createdAt": "2024-07-15T00:00:00.000Z", // 생성일
        "updatedAt": "2024-07-15T00:00:00.000Z", // 수정일
        "managerNames": ["이용우"], // 계약서 담당자 이름 목록
        "signatureCount": 3, // signatureCount=true로 넘긴 경우에만 확인 가능
        "participants": [
          {
            // 전자서명 참여자
            "id": 987, // 고유 식별 id
            "order": 1, // 전자서명 참여 순서
            "role": "고객" // 역할 이름 (ex. 갑, 고객, 등)
          }
        ]
      }
    ],
    "total": 1
  }
}
```

<br>