---
title: "수신거부 목록 조회"
method: GET
path: "/v2/contacts/blocklist"
tags: ["Contacts"]
---

# 수신거부 목록 조회

`GET /v2/contacts/blocklist`

등록된 수신거부 목록을 조회합니다. 각 수신거부 항목에는 전화번호, 발신번호, 등록 일시 등이 포함되며, 페이지네이션을 지원하여 대량의 데이터도 효율적으로 조회할 수 있습니다.

## Query parameters

- `senderNumber` string
- `kakaoChannelIds` string[]
- `blockType` string[]
- `startDate` string
- `endDate` string
- `limit` number
- `cursor` number

## Response `200`

수신거부 목록 조회가 성공적으로 완료되었습니다. 등록된 수신거부 항목들과 페이지네이션 정보가 반환됩니다.

- GetBlocklistResponseDto
  - `code` number, required — HTTP 상태 코드입니다. 200이면 성공, 400대는 클라이언트 오류, 500대는 서버 오류를 나타냅니다.
  - `message` string, required — API 호출 결과에 대한 사람이 읽을 수 있는 메시지입니다. 성공 시 "OK", 실패 시 구체적인 오류 사유가 포함됩니다.
  - `data` GetBlocklistResponse, required
    - `cursor` number — 다음 페이지를 요청할 때 사용할 커서 값입니다. 더 이상 데이터가 없으면 null이 됩니다.
    - `blocklist` BlocklistDto[], required — 현재 페이지에 해당하는 수신거부 목록입니다. 각 항목에는 전화번호, 발신번호, 등록 일시 등이 포함됩니다.
      - `userId` number, required — 수신거부를 등록할 사용자 ID입니다.
      - `channelId` number, required — 수신거부를 적용할 채널 ID입니다.
      - `phoneNumber` string, required — 수신거부를 원하는 수신자의 전화번호입니다. 하이픈(-) 없이 숫자만 입력합니다.
      - `senderNumber` string, required — 수신거부를 적용할 발신번호입니다. 해당 발신번호로부터의 메시지 수신을 거부하게 됩니다.
      - `blockId` number, required — 수신거부 항목 ID입니다.
      - `blockType` 'WEB' | 'API' | 'ARS', required — 수신거부 유형입니다. 어떤 경로로 수신거부가 되었는지를 나타냅니다.
      - `blockDomain` string, required — 수신거부 도메인입니다. 어떤 도메인에서 수신거부가 되었는지를 나타냅니다.
      - `messageType` 'SMS' | 'KAKAO' | 'RCS', required — 메시지 유형입니다. 어떤 유형의 메시지에서 수신거부가 되었는지를 나타냅니다.
      - `kakaoChannelId` string, required — 카카오 채널 ID입니다. 어떤 카카오 채널에서 수신거부가 되었는지를 나타냅니다.
      - `rcsBrandId` string, required — RCS 브랜드 ID입니다. 어떤 RCS 브랜드에서 수신거부가 되었는지를 나타냅니다.
      - `rcsChatbotId` string, required — RCS 챗봇 ID입니다. 어떤 RCS 챗봇에서 수신거부가 되었는지를 나타냅니다.
      - `createdAt` string, date-time, required — 수신거부 항목이 생성된 날짜와 시간입니다.
      - `updatedAt` string, date-time, required — 수신거부 항목이 마지막으로 수정된 날짜와 시간입니다.
    - `totalCount` number, required — 검색 조건에 맞는 전체 수신거부 항목의 총 개수입니다. 페이징 처리를 위해 사용됩니다.

---

[API](https://skmtc.net/sendon/apis/sendon-api.md) · [All operations](https://skmtc.net/sendon/apis/sendon-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sendon/sendon-api/revisions/525dedc81a05/schema)