API

차단 목록 조회

작성일 2026.03.23 | 수정일 2026.03.23

GET/black/

Query

type— 수신거부 타입 (DENIAL: 080수신거부, SPAM: 스팸 신고건)

senderNumber— 발신번호

startKey— 페이지네이션 시작 키 (최대 32자)

limit— 조회 개수 (기본값: 20)

dateCreated— 생성 일시 필터 (연산자: gte, lte, gt, lt, eq 지원)

dateUpdated— 수정 일시 필터 (연산자: gte, lte, gt, lt, eq 지원)

계정에 등록된 발신번호에 대한 080 수신거부 및 KISA 차단 목록을 조회합니다. 계정에 활성화된 발신번호가 없으면 빈 목록이 반환됩니다.

Response

Name	Type	Required	Description
startKey	String	*	현재 페이지 시작 키
nextKey	String	*	다음 페이지 시작 키 (다음 페이지가 없으면 null)
limit	Number	*	조회 개수
blackList	Array	*	차단 목록
handleKey	String	*	차단 항목 고유 키
type	String	*	차단 타입 (DENIAL: 080수신거부, SPAM: 스팸 신고)
senderNumber	String	*	발신번호
recipientNumber	String	*	수신번호 (차단 요청한 번호)
dateCreated	Date	*	차단 등록 일시
dateUpdated	Date	*	수정 일시

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"
    }
  ]
}