API

발신번호 개수 증가 요청

작성일 2026.03.17 | 수정일 2026.03.24

POST/senderid/v1/papers/limitation

발신번호 등록 가능 개수(기본 5개)를 늘리기 위해 관리자에게 요청합니다. 증빙서류를 첨부해야 합니다.

Body Params

Name	Type	Required	Description
documents	string[]	*	증빙서류 문서 ID 배열. 사전에 업로드한 문서의 ID를 전달합니다.
limit	number	*	요청할 발신번호 개수 한도

Response

limitationDocuments 배열에 요청 정보가 추가됩니다.

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

Request

{
  "documents": [
    "DOC_abc123",
    "DOC_def456"
  ],
  "limit": 20
}

Response

{
  "accountId": "12345678901234",
  "limit": 5,
  "senderIds": [
    {
      "handleKey": "SID_abc123",
      "phoneNumber": "01012345678",
      "status": "ACTIVE",
      "method": "SELF-CERT",
      "expireAt": "2025-01-01T12:00:00.000Z",
      "autoExtension": true,
      "necessaryMeasures": null,
      "consignment": false,
      "approvalDocuments": [],
      "unlockDuplicate": null,
      "dateCreated": "2024-07-01T12:00:00.000Z",
      "dateUpdated": "2024-07-01T12:00:00.000Z"
    }
  ],
  "limitationDocuments": [
    {
      "limitationId": "LIM_abc123",
      "documents": [
        "DOC_abc123",
        "DOC_def456"
      ],
      "limitRequested": 20,
      "limitBeforeRequest": 5,
      "reason": null,
      "status": "PENDING",
      "dateCreated": "2024-07-01T12:00:00.000Z",
      "dateUpdated": "2024-07-01T12:00:00.000Z"
    }
  ],
  "dateCreated": "2024-01-01T00:00:00.000Z",
  "dateUpdated": "2024-07-01T12:00:00.000Z"
}