API

발신번호 정보 조회

작성일 2026.03.17 | 수정일 2026.03.25

GET/senderid/v1/numbers

계정에 등록된 발신번호 전체 정보를 조회합니다. 등록된 발신번호가 없으면 기본 빈 데이터가 생성됩니다.

Response

Name	Type	must	Description
accountId	string	*	계정 고유 ID
limit	number	*	발신번호 등록 가능 개수 (기본값: 5)
senderIds	array	*	발신번호 목록 (삭제된 번호 제외)
handleKey	string	*	발신번호 고유 키
phoneNumber	string	*	발신번호
status	string	*	발신번호 상태. PENDING, ACTIVE, INACTIVE, BLOCKED, DUPLICATED, EXPIRED, OVERLIMIT 중 하나
method	string		인증 방법. SELF-CERT, DOCUMENT, ADMIN 중 하나
expireAt	string\|null		만료일시 (ISO 8601). 본인인증 등록 시 6개월 후로 설정됩니다.
autoExtension	boolean		자동 연장 여부 (기본값: true)
necessaryMeasures	string[]\|null		필요한 추가 조치 목록. DUPLICATED, OVERLIMIT, BUSINESS_DOCUMENTS, CONSIGNMENT_DOCUMENTS
consignment	boolean		위임 번호 여부
approvalDocuments	array		증빙서류 심사 내역
unlockDuplicate	object		중복 해제 요청 정보
dateCreated	string	*	등록일시 (ISO 8601)
dateUpdated	string	*	수정일시 (ISO 8601)
limitationDocuments	array	*	개수 제한 해제 요청 내역
dateCreated	string	*	생성일시 (ISO 8601)
dateUpdated	string	*	수정일시 (ISO 8601)

Structure

Response

{
  "accountId": "12345678901234",
  "limit": 5,
  "senderIds": [
    {
      "handleKey": "SID_abc123",
      "phoneNumber": "01012345678",
      "status": "PENDING",
      "method": null,
      "expireAt": null,
      "autoExtension": true,
      "necessaryMeasures": [
        "BUSINESS_DOCUMENTS"
      ],
      "consignment": false,
      "approvalDocuments": [
        {
          "approvalId": "APR_abc123",
          "status": "PENDING",
          "reason": null,
          "documentList": {
            "certificateDocument": [
              "DOC_abc123"
            ],
            "employmentCertificate": "DOC_def456"
          },
          "consignmentDocumentList": null,
          "dateCreated": "2024-07-01T12:00:00.000Z",
          "dateUpdated": "2024-07-01T12:00:00.000Z"
        }
      ],
      "unlockDuplicate": null,
      "dateCreated": "2024-07-01T12:00:00.000Z",
      "dateUpdated": "2024-07-01T12:00:00.000Z"
    }
  ],
  "limitationDocuments": [],
  "dateCreated": "2024-01-01T00:00:00.000Z",
  "dateUpdated": "2024-07-01T12:00:00.000Z"
}