API

수신자 차단 목록 조회

작성일 2026.03.23 | 수정일 2026.03.23

GET/black/optouts/:phoneNumber
Parameters
phoneNumber*— 조회할 수신 전화번호 (ARS 인증된 번호와 일치해야 함)
Query
type— 수신거부 타입 (DENIAL: 080수신거부, SPAM: 스팸 신고건)
startKey— 페이지네이션 시작 키 (최대 32자)
limit— 조회 개수 (기본값: 20)
dateCreated— 생성 일시 필터 (연산자: gte, lte, gt, lt, eq 지원)
dateUpdated— 수정 일시 필터 (연산자: gte, lte, gt, lt, eq 지원)

특정 수신번호에 대한 080 수신거부 및 KISA 차단 목록을 조회합니다.

  • ARS 전화 인증을 통한 MFA 인증이 필요합니다.

  • 인증된 전화번호와 요청한 전화번호가 일치해야 합니다.

Response

NameTypeRequiredDescription
startKeyString*현재 페이지 시작 키
nextKeyString*다음 페이지 시작 키
limitNumber*조회 개수
blackListArray*차단 목록
handleKeyString*차단 항목 고유 키
typeString*차단 타입
senderNumberString*발신번호
recipientNumberString*수신번호
dateCreatedDate*차단 등록 일시
dateUpdatedDate*수정 일시

Structure

Response
{ "startKey": null, "nextKey": null, "limit": 20, "blackList": [ { "handleKey": "IM01BL2403201400000000abcdefgh", "type": "DENIAL", "senderNumber": "029302266", "recipientNumber": "01012345678", "dateCreated": "2024-03-20T14:00:00.000Z", "dateUpdated": "2024-03-20T14:00:00.000Z" } ] }