---
title: "분할 예약 목록 조회"
method: GET
path: "/v2/messages/sms/groups/{groupId}/repeats"
tags: ["SMS"]
---

# 분할 예약 목록 조회

`GET /v2/messages/sms/groups/{groupId}/repeats`

예약된 문자 메시지의 분할 발송 목록을 조회합니다. 대용량 발송을 위한 분할 예약 정보를 확인할 수 있습니다.

## Path parameters

- `groupId` string, required

## Query parameters

- `limit` number
- `cursor` string

## Response `200`

분할 예약 목록 조회가 성공적으로 완료되었습니다. 분할별 예약 정보와 페이지네이션 정보가 반환됩니다.

- SearchRepeatsResponseDto
  - `code` number, required — HTTP 상태 코드입니다. 200이면 성공, 400대는 클라이언트 오류, 500대는 서버 오류를 나타냅니다.
  - `message` string, required — API 호출 결과에 대한 사람이 읽을 수 있는 메시지입니다. 성공 시 "성공", 실패 시 구체적인 오류 사유가 포함됩니다.
  - `data` SearchRepeats, required
    - `items` RepeatInfo[], required — 조회된 분할 발송 예약들의 목록입니다. 각 예약의 상태와 진행 현황이 포함됩니다.
      - `groupId` string, required — 분할 발송에 속한 메시지 그룹의 ID입니다.
      - `repeatId` string, required — 분할 발송의 개별 예약 ID입니다.
      - `repeatStatus` 'RESERVED' | 'PROCESSING' | 'COMPLETED' | 'FAILED' | 'CANCELED', required — 분할 발송 배치의 현재 예약 상태입니다. RESERVED(예약됨), PROCESSING(처리중), COMPLETED(완료) 등의 상태를 나타냅니다.
      - `cancelRequestTime` string, required — 분할 발송 예약 취소 요청이 접수된 날짜와 시간입니다. ISO 8601 형식으로 표시됩니다.
      - `cancelRequestIp` string, required — 분할 발송 예약 취소 요청을 보낸 클라이언트의 IP 주소입니다. 보안 및 추적 목적으로 기록됩니다.
      - `cancelTime` string, required — 분할 발송 예약이 최종적으로 취소된 날짜와 시간입니다. ISO 8601 형식으로 표시됩니다.
      - `repeatSendTime` string, required — 분할 발송 예약 메시지가 발송될 예정인 날짜와 시간입니다. ISO 8601 형식으로 표시됩니다.
      - `messageCount` number, required — 해당 분할 발송 예약에 포함된 메시지의 총 개수입니다. 이 예약으로 발송될 메시지 수입니다.
      - `startMessageId` number, required — 해당 분할 발송 예약의 시작 메시지 ID입니다. 이 예약에 포함된 메시지 범위의 시작 ID입니다.
      - `endMessageId` number, required — 해당 분할 발송 예약의 마지막 메시지 ID입니다. 이 예약에 포함된 메시지 범위의 끝 ID입니다.
      - `standbyCount` number, required — 분할 발송 예약 중 아직 발송되지 않고 대기 중인 메시지의 수입니다.
      - `succeededCount` number, required — 분할 발송 예약 중 성공적으로 발송 완료된 메시지의 수입니다.
      - `failedCount` number, required — 분할 발송 예약 중 발송에 실패했거나 취소된 메시지의 수입니다.
      - `canceledCount` number, required — 분할 발송 예약 중 사용자가 직접 취소한 메시지의 수입니다.
      - `sendingCount` number, required — 분할 발송 예약 중 현재 통신사로 전송 중인 메시지의 수입니다.
    - `cursor` string, required — 다음 페이지 조회를 위한 커서 값입니다. 더 이상 조회할 데이터가 없으면 null이 됩니다.

---

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