API

활성화된 발신번호 목록 조회

작성일 2026.03.17 | 수정일 2026.03.25

GET/senderid/v1/numbers/active

사용 가능한(ACTIVE 상태) 발신번호 목록만 조회합니다.

Response

아래의 활성화된 발신번호 객체의 배열을 반환합니다.

Name	Type	must	Description
phoneNumber	string	*	발신번호
handleKey	string	*	발신번호 고유 키
status	string	*	항상 'ACTIVE'
method	string		인증 방법
expireAt	string\|null		만료 일시 (ISO 8601)
dateCreated	string	*	등록 일시 (ISO 8601)
dateUpdated	string	*	수정 일시 (ISO 8601)

Structure

Response

[
  {
    "handleKey": "SID_abc123",
    "phoneNumber": "01012345678",
    "status": "ACTIVE",
    "method": "SELF-CERT",
    "expireAt": "2025-01-01T12:00:00.000Z",
    "dateCreated": "2024-07-01T12:00:00.000Z",
    "dateUpdated": "2024-07-01T12:00:00.000Z"
  }
]