---
title: "문자 메시지 발송 상세 조회"
method: GET
path: "/v2/messages/sms/groups/{groupId}"
tags: ["SMS"]
---

# 문자 메시지 발송 상세 조회

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

특정 메시지 그룹의 발송 요청 상세 정보를 조회합니다.

## Path parameters

- `groupId` string, required

## Response `200`

문자 메시지 발송 상세 조회가 성공적으로 완료되었습니다. 요청한 메시지의 발송 상태와 정보가 반환됩니다.

- GetMessageResponseDto
  - `code` number, required — HTTP 상태 코드입니다. 200이면 성공, 400대는 클라이언트 오류, 500대는 서버 오류를 나타냅니다.
  - `message` string, required — API 호출 결과에 대한 사람이 읽을 수 있는 메시지입니다. 성공 시 "성공", 실패 시 구체적인 오류 사유가 포함됩니다.
  - `data` MessageInfo, required
    - `groupId` string — 메시지 그룹의 ID입니다.
    - `channelId` string — 메시지가 발송된 채널의 ID입니다.
    - `contactsGroups` string[] — 메시지 발송에 사용된 주소록 그룹들의 ID 목록입니다. 주소록 기능을 사용하여 발송한 경우에만 값이 있습니다.
    - `contactsMemberId` string[] — 메시지 발송에 사용된 주소록 멤버들의 ID 목록입니다. 특정 멤버들에게만 발송한 경우에만 값이 있습니다.
    - `countRequest` number — 요청된 전체 메시지 발송 수입니다.
    - `title` string — LMS 또는 MMS 메시지의 제목입니다. SMS의 경우 제목이 없으므로 null이 될 수 있습니다.
    - `message` string — 실제 발송된 메시지의 본문 내용입니다. SMS는 90바이트, LMS는 2000바이트 이내의 텍스트가 포함됩니다.
    - `messageType` 'SMS' | 'LMS' | 'MMS' — 발송된 메시지의 타입입니다. SMS(단문), LMS(장문), MMS(그림문자) 중 하나의 값을 가집니다.
    - `requestIp` string — 메시지 발송을 요청한 클라이언트의 IP 주소입니다. 보안 및 추적 목적으로 기록됩니다.
    - `senderNumber` string — 메시지를 발송한 발신번호입니다. 수신자에게 표시되는 전화번호로, 사전에 등록되고 승인된 번호입니다.
    - `repeatCount` number, required — 대량 발송 시 분할하여 발송할 총 횟수입니다. 서버 부하를 줄이고 안정적인 발송을 위해 사용됩니다.
    - `repeatInterval` number, required — 분할 발송 간의 시간 간격입니다. repeatUnit과 함께 사용하여 "5분마다", "1시간마다" 등을 설정합니다.
    - `repeatUnit` 'MINUTE' | 'HOUR' | 'DAY' | 'WEEK' | 'MONTH' | 'YEAR', required — 분할 발송 간격의 시간 단위입니다. MINUTE, HOUR, DAY, WEEK, MONTH, YEAR 중 하나의 값을 가집니다.
    - `repeatStartTime` string, required — 예약 발송이 시작되는 날짜와 시간입니다. ISO 8601 형식으로 표시됩니다.
    - `userId` string — 메시지를 발송한 사용자의 ID입니다.
    - `isUseApi` boolean — API를 통한 발송인지 여부입니다. true이면 API 호출, false이면 웹 콘솔을 통한 발송입니다.
    - `imageIds` string[] — MMS 메시지에 첨부된 이미지 파일들의 ID 목록입니다. 최대 3개까지 첨부할 수 있습니다.
    - `messageCount` number — 실제 발송된 메시지 수입니다.
    - `standbyCount` number — 발송 대기 중인 메시지의 수입니다. 아직 통신사로 전송되지 않은 메시지 개수입니다.
    - `sendingCount` number — 현재 발송 중인 메시지의 수입니다. 통신사로 전송되었지만 아직 최종 결과를 받지 못한 메시지 개수입니다.
    - `succeededCount` number — 성공적으로 발송 완료된 메시지의 수입니다. 수신자에게 정상적으로 전달된 메시지 개수입니다.
    - `failedCount` number — 발송에 실패한 메시지의 수입니다. 통신사 오류, 잘못된 번호, 취소된 메시지 등이 포함됩니다.
    - `canceledCount` number — 사용자가 직접 취소한 메시지의 수입니다. 예약 발송 중 취소 요청으로 발송되지 않은 메시지 개수입니다.
    - `blockedCount` number — 수신거부로 인해 발송되지 않은 메시지의 수입니다. 수신자가 사전에 수신거부를 신청한 경우입니다.
    - `pointId` string — 메시지 발송에 사용된 포인트 계정의 ID입니다.
    - `usedPoints` number, required — 메시지 발송으로 차감된 총 포인트입니다. 부가세(VAT)가 포함된 최종 차감 포인트입니다.
    - `refundPoints` number, required — 발송 취소나 실패로 환급된 포인트 총액입니다. 부가세(VAT)가 포함된 최종 환급 포인트 금액입니다.
    - `usedNetPoints` number, required — 메시지 발송에 사용된 포인트 중 부가세(VAT)를 제외한 금액입니다.
    - `refundNetPoints` number, required — 환급된 포인트 중 부가세(VAT)를 제외한 금액입니다.
    - `usedVatPoints` number, required — 메시지 발송으로 차감된 부가세(VAT) 포인트입니다. 전체 사용 포인트에서 부가세에 해당하는 금액입니다.
    - `refundVatPoints` number, required — 환급된 부가세(VAT) 포인트입니다. 전체 환급 포인트에서 부가세에 해당하는 금액입니다.
    - `usedCredits` number, required — 메시지 발송에 사용된 크레딧입니다. 포인트 대신 사용할 수 있는 무료 크레딧이나 프로모션 크레딧 사용량입니다.
    - `refundCredits` number, required — 발송 취소나 실패로 환급된 크레딧입니다. 사용되지 않은 무료 크레딧이나 프로모션 크레딧의 환급량입니다.
    - `unitCost` string — 메시지 발송에 적용된 단가입니다. 메시지 타입별로 다른 단가가 적용됩니다.
    - `groupStatus` 'NONE' | 'RESERVED' | 'PROCESSING' | 'COMPLETED' | 'FAILED' | 'CANCELED' — 메시지 그룹의 전체적인 발송 상태입니다. NONE, RESERVED, PROCESSING, COMPLETED, FAILED, CANCELED 중 하나의 값을 가집니다.
    - `reservedStatus` 'RESERVED' | 'PROCESSING' | 'COMPLETED' | 'FAILED' | 'CANCELED' — 예약 발송의 현재 상태입니다. 예약된 메시지의 처리 상태를 나타냅니다.
    - `cancelStatus` string — 예약 발송 취소 요청의 처리 상태입니다. 취소 요청이 성공했는지 여부를 나타냅니다.
    - `createdAt` string — 메시지가 생성된 날짜와 시간입니다. ISO 8601 형식으로 표시됩니다.
    - `isAd` boolean — 광고성 메시지 여부입니다. 광고성 메시지는 관련 법규에 따라 수신자의 사전 동의가 필요합니다.
    - `toType` 'json' | 'csv' | 'text', required — 수신자 유형

---

[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)