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

# 통합 수신거부 목록 조회

`GET /v2/contacts/blocklist/unified`

## Request

- Base URL: `https://api.sendon.io`
- URL: `https://api.sendon.io/v2/contacts/blocklist/unified`
- Auth: HTTP basic

등록된 통합 수신거부 목록을 조회합니다. 각 항목에는 전화번호, 등록 경로, 등록 당시의 메시지 유형과 발신정보가 포함되며, 페이지네이션을 지원합니다.

## Query parameters

- `messageType` 'DIRECT' | 'SMS' | 'KAKAO' | 'RCS'
- `blockType` string[]
- `keyword` string
- `startDate` string
- `endDate` string
- `limit` number
- `cursor` number

## Response `200`

통합 수신거부 목록 조회가 성공적으로 완료되었습니다.

- GetBlocklistUnifiedResponseDto
  - `code` number, required: HTTP 상태 코드입니다. 200이면 성공, 400대는 클라이언트 오류, 500대는 서버 오류를 나타냅니다.
  - `message` string, required: API 호출 결과에 대한 사람이 읽을 수 있는 메시지입니다. 성공 시 "OK", 실패 시 구체적인 오류 사유가 포함됩니다.
  - `data` GetBlocklistUnifiedResponse, required
    - `cursor` number: 다음 페이지 조회에 사용할 커서 값입니다. 더 가져올 데이터가 없으면 반환되지 않습니다.
    - `blocklist` BlocklistUnifiedDto[], required: 통합 수신거부 목록입니다.
      - `userId` number, required: 통합 수신거부를 등록한 사용자 ID입니다.
      - `phoneNumber` string, required: 수신거부된 수신자의 전화번호입니다. 하이픈(-) 없이 숫자만 표시됩니다.
      - `blockId` number, required: 통합 수신거부 항목의 고유 ID입니다. 해제 시 이 값을 사용합니다.
      - `blockType` 'WEB' | 'API' | 'ARS', required: 수신거부가 등록된 경로입니다. WEB(웹사이트), API(API 호출), ARS(전화 수신거부) 중 하나입니다.
      - `messageType` 'DIRECT' | 'SMS' | 'KAKAO' | 'RCS', required: 등록 당시의 메시지 유형입니다. DIRECT(발신정보 없이 직접 등록), SMS, KAKAO, RCS 중 하나이며, 통합 수신거부의 차단 판정은 유형과 무관하게 계정 단위로 적용됩니다.
      - `senderNumber` string, nullable: 등록 당시의 발신번호입니다. SMS 유입분에만 값이 있습니다.
      - `kakaoChannelId` string, nullable: 등록 당시의 카카오 채널 이름입니다. KAKAO 유입분에만 값이 있습니다.
      - `rcsBrandId` string, nullable: 등록 당시의 RCS 브랜드ID입니다. RCS 유입분에만 값이 있습니다.
      - `rcsChatbotId` string, nullable: 등록 당시의 RCS 챗봇ID입니다. RCS 유입분에만 값이 있습니다.
      - `createdAt` string, date-time, required: 통합 수신거부가 등록된 일시입니다.
      - `updatedAt` string, date-time, required: 통합 수신거부가 마지막으로 수정된 일시입니다.
    - `totalCount` number, required: 조건에 해당하는 전체 통합 수신거부 수입니다.

## Changes

- **2026-11-03** `71dc377792d9`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/sendon/apis/sendon-api/changes/v2/contacts/blocklist/unified/get.md)

---

[API](https://skmtc.dev/sendon/apis/sendon-api.md) - [All operations](https://skmtc.dev/sendon/apis/sendon-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sendon/apis/sendon-api/revisions/71dc377792d9?raw)