---
title: "템플릿 리스트 조회"
method: GET
path: "/templates"
tags: ["USER API"]
---

# 템플릿 리스트 조회

`GET /templates`

## Query parameters

- `offset` integer
- `limit` integer
- `metadatas` string, nullable
- `filter` string, nullable

## Response `200`

- GetTemplatesResponseDto
  - `count` number, required — 총 템플릿 개수
  - `templates` TemplateInTemplatesResponseDto[], required — 템플릿 목록
    - `id` string, required — 템플릿의 ID
    - `metadatas` MetadataInTemplatesResponseDto[], required — 메타데이터 리스트(응답의 메타데이터는 순서가 보장되지 않습니다)
      - `key` string, required — 메타데이터 키
      - `value` string, required — 메타데이터 값
    - `title` string, required — 템플릿 제목
    - `file` TemplateFileInTemplatesResponseDto, required
      - `downloadUrl` string, required — 다운로드 링크(유효시간: 10분)
    - `participants` ParticipantInTemplatesResponseDto[], required — 템플릿 참여자 정보
      - `type` object, required — 참여자 타입
      - `role` string, required — 참여자의 역할
      - `signingOrder` integer, required — 참여자의 참여 순서
      - `name` string, nullable, required — 참여자의 이름 (공란일 수 있음)
      - `signingMethod` SigningMethodInTemplatesResponseDto, required
        - `type` 'KAKAO' | 'EMAIL' | 'IN_PERSON', required — 참여자 참여 수단의 종류
        - `value` string, required — 참여자의 참여 수단 (이메일 또는 휴대전화번호)
    - `labels` LabelInTemplatesResponseDto[], required — 라벨 리스트(응답의 라벨은 순서가 보장되지 않습니다)
      - `id` string, required — 라벨 ID
      - `name` string, required — 라벨 이름
      - `description` string, nullable, required — 라벨의 설명
    - `createdAt` string, date-time, required — 템플릿 생성 시간
    - `updatedAt` string, date-time, required — 템플릿 마지막 업데이트 시간

---

[API](https://skmtc.net/modusign/apis/modusign-api.md) · [All operations](https://skmtc.net/modusign/apis/modusign-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/modusign/modusign-api/versions/5772e872cbf9/schema)