API

수신거부 번호 조회

작성일 2026.03.23 | 수정일 2026.03.23

GET/block/numbers/
Query
blockNumberId— 수신거부 번호 핸들키
phoneNumber— 전화번호
startKey— 페이지네이션 시작 키 (이전 응답의 nextKey 값 사용)
limit— 조회 개수 (기본값: 20)
blockGroupId— 소속된 수신거부 그룹의 핸들키
memo— 메모 (부분 일치 검색 지원)

등록된 수신거부 번호 목록을 조회합니다. 페이지네이션을 지원하며, 다양한 필터 조건으로 검색할 수 있습니다.

Response

NameTypeRequiredDescription
startKeyString*현재 페이지 시작 키
nextKeyString*다음 페이지 시작 키 (다음 페이지가 없으면 null)
limitNumber*조회 개수
blockNumbersArray*수신거부 번호 목록
blockNumberIdString*수신거부 번호 핸들키
accountIdString*계정 고유 ID
phoneNumberString*수신거부 전화번호
memoString*메모 (최대 250자)
blockGroupIdsArray*소속 그룹 핸들키 목록
dateCreatedDate*등록 일시 (ISO 8601)
dateUpdatedDate*수정 일시 (ISO 8601)

Structure

Response
{ "startKey": null, "nextKey": "IM01BN2403201400000000abcdefgh", "limit": 20, "blockNumbers": [ { "blockNumberId": "IM01BN2403201400000000abcdefgh", "accountId": "12345678901234", "phoneNumber": "01012345678", "memo": "고객 요청에 의한 수신거부", "blockGroupIds": [ "IM01BG2403201400000000abcdefgh" ], "dateCreated": "2024-03-20T14:00:00.000Z", "dateUpdated": "2024-03-20T14:00:00.000Z" } ] }