--- updatedAt: 2026-08-27T04:52:17.000Z agentTools: projectIndex: https://sdk.sendon.io/llms.txt --- # 통합 수신거부 목록 조회 등록된 통합 수신거부 목록을 조회합니다. 각 항목에는 전화번호, 등록 경로, 등록 당시의 메시지 유형과 발신정보가 포함되며, 페이지네이션을 지원합니다. 센드온 API는 네트워크 에러를 분리하기 위해 HTTP 상태 코드 200으로 응답합니다. 자세한 응답 코드는 [API 응답 코드 가이드](https://sdk.sendon.io/reference/4-api-%EC%9D%91%EB%8B%B5-%EC%BD%94%EB%93%9C-%EA%B0%80%EC%9D%B4%EB%93%9C#/) 를 참고해주세요. # OpenAPI definition ```json { "openapi": "3.0.0", "paths": { "/v2/contacts/blocklist/unified": { "get": { "operationId": "BlocklistUnifiedController_getBlocklist", "summary": "통합 수신거부 목록 조회", "description": "등록된 통합 수신거부 목록을 조회합니다. 각 항목에는 전화번호, 등록 경로, 등록 당시의 메시지 유형과 발신정보가 포함되며, 페이지네이션을 지원합니다.", "parameters": [ { "required": false, "description": "등록 당시의 메시지 유형으로 필터링합니다. DIRECT, SMS, KAKAO, RCS 중에서 선택할 수 있습니다.", "example": "DIRECT", "name": "messageType", "in": "query", "schema": { "enum": [ "DIRECT", "SMS", "KAKAO", "RCS" ], "type": "string" } }, { "required": false, "description": "수신거부가 등록된 경로로 필터링합니다. WEB(웹사이트), API(API 호출), ARS(전화 수신거부) 중에서 선택할 수 있습니다.", "example": [ "WEB", "API" ], "name": "blockType", "in": "query", "schema": { "type": "array", "items": { "type": "string", "enum": [ "WEB", "API", "ARS" ] } } }, { "required": false, "description": "전화번호 검색어입니다. 입력한 문자열이 포함된 전화번호만 조회합니다.", "example": "0101234", "name": "keyword", "in": "query", "schema": { "type": "string" } }, { "required": false, "description": "조회할 기간의 시작 날짜와 시간입니다. YYYY-MM-DD HH:mm:ss 형식으로 입력해주세요.", "example": "2024-07-09 17:00:00", "name": "startDate", "in": "query", "schema": { "type": "string" } }, { "required": false, "description": "조회할 기간의 종료 날짜와 시간입니다. YYYY-MM-DD HH:mm:ss 형식으로 입력해주세요.", "example": "2024-07-09 18:00:00", "name": "endDate", "in": "query", "schema": { "type": "string" } }, { "description": "한 번에 가져올 통합 수신거부 목록의 최대 개수입니다. 너무 큰 값을 설정하면 응답 속도가 느려질 수 있습니다.", "required": false, "example": 20, "name": "limit", "in": "query", "schema": { "default": 20, "type": "number" } }, { "description": "페이징을 위한 커서 값입니다. 다음 페이지를 가져올 때 이전 응답에서 받은 cursor 값을 사용하세요.", "required": false, "example": 0, "name": "cursor", "in": "query", "schema": { "default": 0, "type": "number" } } ], "responses": { "200": { "description": "통합 수신거부 목록 조회가 성공적으로 완료되었습니다.", "content": { "application/json": { "schema": { "$ref": "#/components/schemas/GetBlocklistUnifiedResponseDto" } } } } }, "tags": [ "Contacts" ], "security": [ { "basic": [] } ] } } }, "info": { "title": "Sendon API", "description": "Sendon API Generated on 2026-08-27T02:12:51.075Z", "version": "v2", "contact": { "name": "센드온", "url": "https://console.sendon.io/", "email": "" }, "license": { "name": "서비스 이용약관", "url": "https://olive-challenge-eca.notion.site/1a43c16d2709804e9de1dd81e0abf477" } }, "servers": [ { "url": "https://api.sendon.io/", "description": "prd" } ], "components": { "securitySchemes": { "basic": { "type": "http", "scheme": "basic" } }, "schemas": { "BlocklistUnifiedDto": { "type": "object", "properties": { "userId": { "type": "number", "description": "통합 수신거부를 등록한 사용자 ID입니다.", "example": 12345 }, "phoneNumber": { "type": "string", "description": "수신거부된 수신자의 전화번호입니다. 하이픈(-) 없이 숫자만 표시됩니다.", "example": "01012345678" }, "blockId": { "type": "number", "description": "통합 수신거부 항목의 고유 ID입니다. 해제 시 이 값을 사용합니다.", "example": 12345 }, "blockType": { "type": "string", "enum": [ "WEB", "API", "ARS" ], "description": "수신거부가 등록된 경로입니다. WEB(웹사이트), API(API 호출), ARS(전화 수신거부) 중 하나입니다.", "example": "API" }, "messageType": { "type": "string", "enum": [ "DIRECT", "SMS", "KAKAO", "RCS" ], "description": "등록 당시의 메시지 유형입니다. DIRECT(발신정보 없이 직접 등록), SMS, KAKAO, RCS 중 하나이며, 통합 수신거부의 차단 판정은 유형과 무관하게 계정 단위로 적용됩니다.", "example": "DIRECT" }, "senderNumber": { "type": "string", "nullable": true, "description": "등록 당시의 발신번호입니다. SMS 유입분에만 값이 있습니다.", "example": "01087654321" }, "kakaoChannelId": { "type": "string", "nullable": true, "description": "등록 당시의 카카오 채널 이름입니다. KAKAO 유입분에만 값이 있습니다.", "example": "센드온" }, "rcsBrandId": { "type": "string", "nullable": true, "description": "등록 당시의 RCS 브랜드ID입니다. RCS 유입분에만 값이 있습니다." }, "rcsChatbotId": { "type": "string", "nullable": true, "description": "등록 당시의 RCS 챗봇ID입니다. RCS 유입분에만 값이 있습니다." }, "createdAt": { "format": "date-time", "type": "string", "description": "통합 수신거부가 등록된 일시입니다." }, "updatedAt": { "format": "date-time", "type": "string", "description": "통합 수신거부가 마지막으로 수정된 일시입니다." } }, "required": [ "userId", "phoneNumber", "blockId", "blockType", "messageType", "createdAt", "updatedAt" ] }, "GetBlocklistUnifiedResponse": { "type": "object", "properties": { "cursor": { "type": "number", "description": "다음 페이지 조회에 사용할 커서 값입니다. 더 가져올 데이터가 없으면 반환되지 않습니다.", "example": 12345 }, "blocklist": { "description": "통합 수신거부 목록입니다.", "type": "array", "items": { "$ref": "#/components/schemas/BlocklistUnifiedDto" } }, "totalCount": { "type": "number", "description": "조건에 해당하는 전체 통합 수신거부 수입니다.", "example": 3 } }, "required": [ "blocklist", "totalCount" ] }, "GetBlocklistUnifiedResponseDto": { "type": "object", "properties": { "code": { "type": "number", "description": "HTTP 상태 코드입니다. 200이면 성공, 400대는 클라이언트 오류, 500대는 서버 오류를 나타냅니다.", "example": 200 }, "message": { "type": "string", "description": "API 호출 결과에 대한 사람이 읽을 수 있는 메시지입니다. 성공 시 \"OK\", 실패 시 구체적인 오류 사유가 포함됩니다.", "example": "OK" }, "data": { "description": "통합 수신거부 목록 조회 결과입니다.", "allOf": [ { "$ref": "#/components/schemas/GetBlocklistUnifiedResponse" } ] } }, "required": [ "code", "message", "data" ] } } } } ```