---
title: "메시지 발송 상세 정보 조회"
method: GET
path: "/v2/statistics/messaging/groups/{groupId}/messages"
tags: ["Statistics"]
---

# 메시지 발송 상세 정보 조회

`GET /v2/statistics/messaging/groups/{groupId}/messages`

특정 메시지 그룹에 속한 모든 개별 메시지의 발송 상세 정보를 조회합니다. 수신자별 발송 결과, 전송 상태, 오류 사유, 발송 일시 등의 세부 정보를 확인할 수 있어 발송 결과 분석에 활용할 수 있습니다.

## Path parameters

- `groupId` string, required

## Query parameters

- `messageStatus` string
- `searchBy` string
- `limit` number
- `cursor` string

## Response `200`

메시지 그룹의 상세 발송 정보 조회가 성공적으로 완료되었습니다. 각 개별 메시지의 발송 결과와 수신자 정보가 반환됩니다.

- MessagingGroupMessagesResponseDto
  - `code` number, required — HTTP 상태 코드입니다. 200이면 성공, 400대는 클라이언트 오류, 500대는 서버 오류를 나타냅니다.
  - `message` string, required — API 호출 결과에 대한 사람이 읽을 수 있는 메시지입니다. 성공 시 "OK", 실패 시 구체적인 오류 사유가 포함됩니다.
  - `data` MessagingGroupMessagesResponse, required
    - `results` MessagingMessage[], required — 검색 조건에 맞는 메시지 발송 내역의 목록입니다. 각 항목에는 발송 결과와 상세 정보가 포함됩니다.
      - `from` string, required — 메시지를 발송한 발신자의 전화번호입니다. 사전에 등록되고 승인된 발신번호만 사용할 수 있습니다.
      - `to` string, required — 메시지를 받을 수신자의 전화번호입니다. 하이픈(-) 없이 숫자만 입력하며, 국제 표준 형식을 따릅니다.
      - `messageId` string, required — 개별 메시지의 ID입니다.
      - `messageSubject` string, required — LMS나 MMS 메시지의 제목입니다. SMS 메시지에는 제목이 없으므로 빈 값이 될 수 있습니다.
      - `messageBody` string, required — 메시지의 본문 내용입니다. 실제로 수신자에게 전달되는 메시지 텍스트를 나타냅니다.
      - `messageStatus` 'STANDBY' | 'SENDING' | 'SUCCEEDED' | 'FAILED' | 'CANCELED' | 'RESERVED' — 메시지 발송의 최종 결과 상태를 나타냅니다. 성공, 실패, 대기, 취소 등의 상태를 구분합니다.
      - `resultCode` string, required — 메시지 발송 결과에 대한 시스템 코드입니다. 성공 시 0, 실패 시 오류 코드가 반환됩니다.
      - `resultText` string, required — 메시지 발송 결과에 대한 사람이 읽을 수 있는 메시지입니다. 성공 시 "성공", 실패 시 구체적인 오류 사유가 포함됩니다.
      - `requestTime` string, required — 메시지 발송 요청이 중개사에 전달된 시간입니다. ISO 8601 형식으로 표시됩니다.
      - `sendTime` string, required — 수신자의 단말기에서 메시지를 받은 시간입니다. ISO 8601 형식으로 표시됩니다.
      - `telecom` string, required — 수신자의 이동통신사를 나타냅니다. SKT, KT, LG U+ 등 통신사별로 구분됩니다.
      - `groupId` string, required — 메시지가 속한 발송 그룹의 ID입니다.
    - `cursor` string — 다음 페이지를 요청할 때 사용할 커서 오프셋 값입니다. 더 이상 데이터가 없으면 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/revisions/525dedc81a05/schema)