API

중복 해제 요청

작성일 2026.03.17 | 수정일 2026.03.25

POST/senderid/v1/papers/duplicate/:phoneNumber

Parameters

phoneNumber— 중복 해제 요청할 발신번호

발신번호 상태가 DUPLICATED(다른 계정에서 이미 사용 중)인 경우, 중복 해제를 요청합니다. 요청 사유를 입력하면 관리자 심사 후 승인/거절됩니다.

Body Params

Name	Type	Required	Description
reason	string	*	중복 해제 요청 사유

Response

unlockDuplicate 필드에 요청 정보가 포함됩니다.

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

{
  "reason": "번호 이전 완료 후 기존 계정에서 해제되지 않은 건입니다."
}

Response

{
  "accountId": "12345678901234",
  "limit": 5,
  "senderIds": [
    {
      "handleKey": "SID_abc123",
      "phoneNumber": "01012345678",
      "status": "DUPLICATED",
      "method": null,
      "expireAt": null,
      "autoExtension": true,
      "necessaryMeasures": [
        "DUPLICATED"
      ],
      "consignment": false,
      "approvalDocuments": [],
      "unlockDuplicate": {
        "duplicateId": "DUP_abc123",
        "name": "홍길동",
        "reasonForRequested": "번호 이전 완료 후 기존 계정에서 해제되지 않은 건입니다.",
        "reason": null,
        "status": "PENDING",
        "dateCreated": "2024-07-01T12:00:00.000Z",
        "dateUpdated": "2024-07-01T12:00:00.000Z"
      },
      "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"
}