톡 스튜디오 · 발송 내역 조회(단건)

발송 내역 조회(단건)

발송 접수 응답의 send_key로 수신자 1명인 발송 결과를 조회합니다. 인증된 워크스페이스의 내역만 조회하며, 없거나 다른 업체의 키는 404입니다. 여러 수신자가 포함된 발송은 400입니다. 조회는 재발송하지 않습니다. 최상위 code는 조회 성공 여부이고, 실제 발송 성공 여부는 status와 result로 확인하세요. 모든 일시는 한국시간(KST)입니다.

인증이 필요한 요청에는 Accesskey · Secretkey 헤더를 첨부합니다. 공통 응답 형식과 에러 코드는 빠른 시작을 참고하세요.

GET /talk/v1/send

발송 내역 조회(단건)

요청 파라미터

이름	타입	필수	기본값	조건	설명
`send_key`	string	필수	-	1~20자	발송 접수 시 반환된 send_key입니다.

응답 파라미터

이름	타입	설명
`traceId`	string	요청 추적 ID입니다.
`code`	string	응답 코드입니다. 성공은 000000입니다.
`message`	string	응답 메시지입니다.
`send_key`	string	조회한 발송 접수 키입니다.
`type`	string	최초 요청 메시지 유형입니다. `SMS`—SMS `LMS`—LMS `MMS`—MMS `AT`—알림톡 `BMF`—브랜드메시지(친구) `BMN`—브랜드메시지(일반)
`to`	string	수신번호입니다.
`status`	string	현재 발송 상태입니다. `RESERVED`—예약 대기 `REVIEW`—검수 대기 `PENDING`—발송 대기 `SENDING`—발송 중 `SENT`—통신사 접수, 결과 대기 `SUCCESS`—발송 성공 `FAIL`—발송 실패 `CANCELLED`—발송 취소
`status_label`	string	발송 상태의 한글 표시입니다.
`is_final`	boolean	SUCCESS/FAIL/CANCELLED이면 true입니다. 접수는 성공 확정이 아닙니다.
`result` 2개 필드	object\|null	확정된 발송 결과입니다. 미확정이면 null입니다.
`code`	string\|null	발송 원장의 표준 결과코드입니다. 코드가 없는 취소/실패는 null입니다.
`message`	string	고객용 결과 메시지입니다. 통신사 원본/내부 오류는 노출하지 않습니다.
`final_type`	string\|null	마지막 시도의 메시지 유형입니다. 시도 전에는 null입니다.
`fallback_used`	boolean	대체 SMS/LMS 시도를 시작했으면 true입니다. 단순 재시도는 false입니다.
`requested_at`	string	발송 요청 접수일시입니다. YYYY-MM-DD HH:mm:ss, KST.
`completed_at`	string\|null	최종 결과 확정일시입니다. 미확정이거나 일시가 없으면 null입니다. KST.

요청 예시

예시 생성 중…

응답 예시 성공

{
  "traceId": "9f2c1a7b-4e0d-4b1a-8c2e-1f3a5d7b9c0e",
  "code": "000000",
  "message": "성공",
  "send_key": "a1b2c3d4e5f6a7b8c9d0",
  "type": "AT",
  "to": "01012345678",
  "status": "SUCCESS",
  "status_label": "발송 성공",
  "is_final": true,
  "result": {
    "code": "000000",
    "message": "성공"
  },
  "final_type": "AT",
  "fallback_used": false,
  "requested_at": "2026-10-20 17:00:00",
  "completed_at": "2026-10-20 17:00:03"
}