발송내역 목록

발송 상태와 실패 사유를 목록으로 조회합니다. 유료 알림톡만 조회되고 무료 커머스 알림톡은 포함되지 않습니다.

GEThttps://message.bootapi.com/alimtalk/messagesBasic Auth

요청 파라미터

파라미터 타입 필수 설명
template_code String 선택 템플릿 코드로 필터링
status String 선택 requested·success·failed·canceled. 그 밖의 값은 오류 없이 무시되어 전체가 조회됩니다
ref_id String 선택 발송할 때 넘긴 멱등 키
to String 선택 수신번호 (하이픈 무관, 정확 매칭)
s_at String 선택 조회 시작 시각 (ISO8601). 접수 시각(created_at) 기준​​입니다 — 예약 시각·발송 시각이 아닙니다
e_at String 선택 조회 종료 시각 (ISO8601)
page Integer 선택 페이지 번호 (기본 1)
limit Integer 선택 페이지 크기 (기본 20, 최대 100)
조회 기간에 상한이 있습니다

기본은 최근 30일, 최대 폭은 92일 입니다. 92일을 넘겨 요청하면 오류가 아니라 시작일을 당겨서 잘라 응답합니다. 실제로 적용된 구간은 응답의 period 로 확인합니다. 날짜로 해석되지 않는 값을 보내도 오류 없이 기본 30일로 조회합니다.

코드 예제

curl -X GET "https://message.bootapi.com/alimtalk/messages?status=failed&limit=20" \
  -H "Authorization: Basic {base64(client_key:secret_key)}"bash

응답

{
  "list": [
    {
      "receipt_id": "68b0f2a1c3d4e5f6a7b8c9d0",
      "ref_id": "order-20260827-0001",
      "to": "01012345678",
      "template_code": "G_RESTOCK_NOTICE_user",
      "status": "success",
      "error_code": null,
      "error_message": null,
      "reserved_at": null,
      "executed_at": "2026-08-27 10:00:03 +0900",
      "delivered_at": "2026-08-27 10:00:05 +0900",
      "created_at": "2026-08-27 10:00:00 +0900"
    }
  ],
  "count": 1,
  "page": 1,
  "per": 20,
  "period": {
    "from": "2026-07-28 10:00:00 +0900",
    "to": "2026-08-27 10:00:00 +0900"
  }
}json
필드 설명
status requested·success·failed·canceled
error_code · error_message 실패 사유 (벤더 코드)
executed_at 전송을 시도한 시각
delivered_at 전달이 확인된 시각
period 실제로 적용된 조회 구간

시각 필드 형식은 응답의 시각 형식을 참고합니다.

수신번호는 마스킹하지 않습니다

가맹점이 직접 보낸 번호이므로 그대로 돌려줍니다.

상태가 requested 에서 안 바뀐다면

상태는 벤더 결과 동기화로 확정됩니다. 접수 직후에는 requested 로 보이고 잠시 뒤 success 나 failed 로 바뀝니다. 폴링 대신 발송결과 웹훅을 등록하면 확정 시점에 바로 받을 수 있습니다.

함께 보기