v1

latestOpenAPI 3.0.2서비스 이용약관2026-07-265758331.1 KB
SMS

문자 메시지 발송 목록 조회

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

get/v2/messages/sms/groups

Query parameters

limitnumber

한 번에 조회할 그룹의 최대 개수입니다. 최소 1개부터 최대 100개까지 설정할 수 있으며, 기본값은 30개입니다.

cursorstring

다음 페이지를 요청할 때 사용할 커서 값입니다. 첫 번째 페이지 요청 시에는 생략하세요.

Response

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

cursorstring required

응답받을 데이터 오프셋을 반환합니다. 페이지네이션이 필요한 경우 활용합니다.

Example response

{
  "items": [
    {
      "isUseApi": true,
      "groupId": "004a6217-f06c-40f6-8f39-bf35b3f76111",
      "status": "COMPLETED",
      "createdAt": "2024-01-15T10:30:00Z",
      "updatedAt": "2024-01-15T11:00:00Z",
      "pointId": "point_12345",
      "unitCosts": 15,
      "usedPoints": 1650,
      "refundPoints": 450,
      "usedNetPoints": 1500,
      "refundNetPoints": 409,
      "usedVatPoints": 150,
      "refundVatPoints": 41,
      "processedCount": 900,
      "canceledCount": 20,
      "messagesCount": 1000,
      "userId": "12345"
    }
  ]
}