Skip to main content
GET
SMS 단건 조회

Authorizations

Authorization
string
header
required

조직 API 키를 Authorization: Bearer <token> 형식으로 보냅니다.

Path Parameters

sms_id
string
required

조회할 SMS 메시지 ID입니다.

Response

성공 응답

v3 발신 SMS 리소스 페이로드입니다.

id
string
required

SMS 메시지의 고유 식별자입니다.

Pattern: ^[0-9a-f]{12}$
Example:

"a1b2c3d4e5f6"

from_number
string
required

발신 번호.

to_number
string
required

수신 번호.

message
string
required

수신자에게 발송된 메시지 본문.

message_type
enum<string>
required

확정된 메시지 유형 ('sms'/'lms'/'mms').

Available options:
sms,
lms,
mms
byte_count
integer
required

메시지 본문의 UTF-8 바이트 수.

Required range: x >= 0
Example:

33

status
enum<string>
required

발송 파이프라인 상태입니다. sent는 릴레이가 요청을 수락했다는 의미로 단말 수신을 보장하지 않습니다. pending은 처리 중, failed는 발송 실패, blocked는 콘텐츠 정책에 의한 거부, legacy는 발송 상태 추적 도입 이전의 과거 레코드입니다.

Available options:
pending,
sent,
failed,
blocked,
legacy
created_at
integer
required

리소스 생성 시각입니다. unix milliseconds 형식입니다.

title
string | null

메시지 제목. 없으면 null.

image_urls
string[] | null

MMS 첨부의 이미지 URL. 텍스트 전용 발송이면 null.

call_id
string | null

귀속된 통화 UUID. 통화 중 에이전트의 send_sms 툴로 발송된 메시지에만 채워지며, POST /v3/sms로 발송된 메시지는 null.

metadata
Metadata · object | null

발신 SMS와 함께 보존된 클라이언트 메타데이터. 없으면 null.