---
title: "문자 메시지 발송 목록 조회"
method: GET
path: "/v2/messages/sms/groups"
tags: ["SMS"]
---

# 문자 메시지 발송 목록 조회

`GET /v2/messages/sms/groups`

사용자가 발송한 문자 메시지의 발송 요청 목록을 조회합니다. 각 요청에는 발송 일시, 성공/실패 수, 예약 상태 등의 요약 정보가 포함됩니다. 페이지네이션을 지원하여 대량의 데이터도 효율적으로 조회할 수 있습니다.

## Query parameters

- `limit` number
- `cursor` string

## Response `200`

발송 이력 조회가 성공적으로 완료되었습니다. 그룹별 발송 내역과 페이지네이션 정보가 반환됩니다.

- SearchGroupsResponseDto
  - `items` Group[], required — 발송 메시지 리스트를 반환합니다.
    - `isUseApi` boolean, required — 메시지 발송이 API를 통해 요청되었는지 여부입니다. true이면 API 호출, false이면 웹 콘솔 사용입니다.
    - `groupId` string, required — 메시지 그룹의 ID입니다.
    - `messageType` 'SMS' | 'LMS' | 'MMS', required — 발송된 메시지의 타입입니다. SMS(단문), LMS(장문), MMS(그림문자) 중 하나의 값을 가집니다.
    - `status` string, required — 메시지 그룹의 현재 발송 상태입니다. RESERVED(예약됨), PROCESSING(처리중), COMPLETED(완료), FAILED(실패), CANCELED(취소) 등의 상태를 나타냅니다.
    - `createdAt` string, required — 메시지 그룹이 최초로 생성된 날짜와 시간입니다. ISO 8601 형식으로 표시됩니다.
    - `updatedAt` string, required — 메시지 그룹의 상태가 마지막으로 업데이트된 날짜와 시간입니다. ISO 8601 형식으로 표시됩니다.
    - `pointId` string, required — 메시지 발송에 사용된 포인트 계정의 ID입니다.
    - `unitCosts` number, required — 메시지 발송에 적용된 단가입니다. 메시지 타입별로 다른 단가가 적용됩니다.
    - `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 — 발송 취소나 실패로 환급된 크레딧입니다. 사용되지 않은 무료 크레딧이나 프로모션 크레딧의 환급량입니다.
    - `processedCount` number, required — 성공적으로 발송 완료된 메시지의 수입니다. 수신자에게 정상적으로 전달된 메시지 개수입니다.
    - `canceledCount` number, required — 사용자가 직접 취소한 메시지의 수입니다. 예약 발송 중 취소 요청으로 발송되지 않은 메시지 수입니다.
    - `messagesCount` number, required — 요청된 전체 메시지 발송 수입니다.
    - `userId` string, required — 메시지를 발송한 사용자의 ID입니다.
  - `cursor` string, 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)