bizgo Developers
API 레퍼런스커뮤니케이션 API카카오 비즈메시지

카카오 비즈메시지(공통)

카카오 비즈메시지 공통 API는 알림톡, 브랜드메시지, 상담톡에서 함께 사용하는 발신프로필과 운영 상태를 조회하거나 관리하는 API입니다.

발신프로필 관리

발신프로필은 카카오 비즈메시지 발송의 기준 정보입니다. 발신프로필 키를 기준으로 상태를 확인하거나 휴면 상태를 해제할 때 사용합니다.

발신프로필 키로 조회

GET/api/comm/v1/center/kakao/sender
샌드박스로 테스트하기

발신프로필 키를 기준으로 카카오 발신프로필 정보를 조회합니다. 알림톡, 브랜드메시지, 상담톡에서 사용하는 senderKey 상태를 확인할 때 사용합니다.

Query Parameters

senderKey

필수String

발신프로필 키입니다.

Returns

common

Object

공통 응답 영역입니다.

data

Object

서비스 응답 영역입니다.

요청 예시

1curl -X GET "https://mars.ibapi.kr/api/comm/v1/center/kakao/sender?senderKey={senderKey}" \
2 -H "Authorization: {ApiKey}"

응답 예시

1{
2 "common": {
3 "authCode":"A000",
4 "authResult":"Success",
5 "infobankTrId":"Infobank-Tracking-Id"
6 },
7 "data": {
8 "code":"A000",
9 "result":"Success",
10 "data": {
11 "kakao": {
12 "senderProfile": {
13 "senderKey":"{senderKey}",
14 "uuid":"b1a2c3d4-e5f6-7890-abcd-ef1234567890",
15 "name":"비즈고",
16 "status":"A",
17 "block": false,
18 "dormant": false,
19 "profileStatus":"A",
20 "createdAt":"2026-04-24T11:18:45+09:00",
21 "modifiedAt":"2026-04-24T11:18:45+09:00",
22 "categoryCode":"001",
23 "bizchat": true,
24 "brandMessage": true,
25 "committalCompanyName":"비즈고",
26 "channelKey":"_X1x2x3x4x5x6x7x8x9x0",
27 "businessProfile": true,
28 "unsubscribePhoneNumber":"0801234567",
29 "unsubscribeAuthNumber":"0801234",
30 "profileSpamLevel":"정상",
31 "profileMessageSpamLevel":"정상",
32 "clearBlockUrl":"https://pf.kakao.com/_X1x2x3/unblock"
33 }
34 }
35 }
36 }
37}

Query Parameters

파라미터타입필수설명
senderKeyString✅발신프로필 키입니다.

Returns

필드타입설명
commonObject공통 응답 영역입니다.
common.authCodeString인증 결과 코드입니다.
common.authResultString인증 결과 메시지입니다.
common.infobankTrIdString트랜잭션 추적 아이디입니다.
dataObject서비스 응답 영역입니다.
data.codeString호출 결과 코드입니다.
data.resultString호출 결과 설명입니다.
data.dataObject실제 응답 데이터입니다.
data.data.kakaoObject카카오 비즈메시지 응답 데이터입니다.
data.data.kakao.senderProfileObject발신프로필 정보입니다.
data.data.kakao.senderProfile.senderKeyString발신프로필 키입니다.
data.data.kakao.senderProfile.uuidString카카오톡 채널입니다.
data.data.kakao.senderProfile.nameString카카오톡 채널 프로필명입니다.
data.data.kakao.senderProfile.statusString상태값입니다. A: 정상
data.data.kakao.senderProfile.blockBoolean발신프로필 차단 여부입니다.
data.data.kakao.senderProfile.dormantBoolean발신프로필 휴면 여부입니다.
data.data.kakao.senderProfile.profileStatusString카카오톡 채널 상태입니다.
A: activated, C: deactivated, B: block, E: deleting
data.data.kakao.senderProfile.createdAtString등록일입니다.
data.data.kakao.senderProfile.modifiedAtString최종 수정일입니다.
data.data.kakao.senderProfile.categoryCodeString카테고리 코드입니다.
data.data.kakao.senderProfile.bizchatBoolean상담톡 사용 여부입니다.
data.data.kakao.senderProfile.brandMessageBoolean브랜드 메시지 타겟팅 M, N, O 사용 여부입니다.
data.data.kakao.senderProfile.committalCompanyNameString상담톡 위탁사 이름입니다.
data.data.kakao.senderProfile.channelKeyString메시지 발송 결과 수신 채널키입니다.
data.data.kakao.senderProfile.businessProfileBoolean카카오톡 채널 비즈니스 인증 여부입니다.
data.data.kakao.senderProfile.unsubscribePhoneNumberString무료수신거부 전화번호입니다.
data.data.kakao.senderProfile.unsubscribeAuthNumberString무료수신거부 인증번호입니다.
data.data.kakao.senderProfile.profileSpamLevelString카카오톡 채널 스팸 상태입니다.
정상 / 경고제한 / 영구제한
data.data.kakao.senderProfile.profileMessageSpamLevelString카카오톡 메시지 스팸 상태입니다.
정상 / 경고제한 / 활동제한
data.data.kakao.senderProfile.clearBlockUrlString알림톡 차단 해제 링크입니다.

요청 예시

Bash
curl -X GET "https://mars.ibapi.kr/api/comm/v1/center/kakao/sender?senderKey={senderKey}" \
  -H "Authorization: {ApiKey}"
JavaScript
const res = await fetch("https://mars.ibapi.kr/api/comm/v1/center/kakao/sender?senderKey={senderKey}", {
  method: "GET",
  headers: {
    "Authorization": "{ApiKey}"
  }
});
Python
import requests

response = requests.get(
    "https://mars.ibapi.kr/api/comm/v1/center/kakao/sender",
    params={"senderKey": "{senderKey}"},
    headers={"Authorization": "{ApiKey}"}
)
data = response.json()
Java
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://mars.ibapi.kr/api/comm/v1/center/kakao/sender?senderKey={senderKey}"))
    .header("Authorization", "{ApiKey}")
    .method("GET", HttpRequest.BodyPublishers.noBody())
    .build();

HttpResponse<String> response = client.send(
    request, HttpResponse.BodyHandlers.ofString()
);

응답 예시

JSON
{
  "common": {
    "authCode": "A000",
    "authResult": "Success",
    "infobankTrId": "Infobank-Tracking-Id"
  },
  "data": {
    "code": "A000",
    "result": "Success",
    "data": {
      "kakao": {
        "senderProfile": {
          "senderKey": "{senderKey}",
          "uuid": "b1a2c3d4-e5f6-7890-abcd-ef1234567890",
          "name": "비즈고",
          "status": "A",
          "block": false,
          "dormant": false,
          "profileStatus": "A",
          "createdAt": "2026-04-24T11:18:45+09:00",
          "modifiedAt": "2026-04-24T11:18:45+09:00",
          "categoryCode": "001",
          "bizchat": true,
          "brandMessage": true,
          "committalCompanyName": "비즈고",
          "channelKey": "_X1x2x3x4x5x6x7x8x9x0",
          "businessProfile": true,
          "unsubscribePhoneNumber": "0801234567",
          "unsubscribeAuthNumber": "0801234",
          "profileSpamLevel": "정상",
          "profileMessageSpamLevel": "정상",
          "clearBlockUrl": "https://pf.kakao.com/_X1x2x3/unblock"
        }
      }
    }
  }
}

발신프로필 휴면 해제

POST/api/comm/v1/center/kakao/sender/recover
샌드박스로 테스트하기

휴면 상태의 발신프로필을 해제합니다. 카카오 비즈메시지 발송 전 발신프로필 상태 복구가 필요한 경우 사용합니다.

Body Parameters

{} JSON

senderKey

필수String

휴면 해제할 발신프로필 키입니다.

Returns

common

Object

공통 응답 영역입니다.

data

Object

서비스 응답 영역입니다.

요청 예시

1curl -X POST "https://mars.ibapi.kr/api/comm/v1/center/kakao/sender/recover" \
2 -H "Authorization: {ApiKey}" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "senderKey": "{senderKey}"
6 }'

응답 예시

1{
2 "common": {
3 "authCode":"A000",
4 "authResult":"Success",
5 "infobankTrId":"Infobank-Tracking-Id"
6 },
7 "data": {
8 "code":"A000",
9 "result":"Success"
10 }
11}

Body Parameters

파라미터타입필수설명
senderKeyString✅휴면 해제할 발신프로필 키입니다.

요청 예시

Bash
curl -X POST "https://mars.ibapi.kr/api/comm/v1/center/kakao/sender/recover" \
  -H "Authorization: {ApiKey}" \
  -H "Content-Type: application/json" \
  -d '{
    "senderKey": "{senderKey}"
  }'
JavaScript
const res = await fetch("https://mars.ibapi.kr/api/comm/v1/center/kakao/sender/recover", {
  method: "POST",
  headers: {
    "Authorization": "{ApiKey}",
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    senderKey: "{senderKey}"
  })
});
Python
import requests

response = requests.post(
    "https://mars.ibapi.kr/api/comm/v1/center/kakao/sender/recover",
    headers={"Authorization": "{ApiKey}"},
    json={"senderKey": "{senderKey}"}
)
data = response.json()
Java
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://mars.ibapi.kr/api/comm/v1/center/kakao/sender/recover"))
    .header("Authorization", "{ApiKey}")
    .method("POST", HttpRequest.BodyPublishers.ofString("{\"senderKey\":\"{senderKey}\"}"))
    .build();

HttpResponse<String> response = client.send(
    request, HttpResponse.BodyHandlers.ofString()
);

응답 예시

JSON
{
  "common": {
    "authCode": "A000",
    "authResult": "Success",
    "infobankTrId": "Infobank-Tracking-Id"
  },
  "data": {
    "code": "A000",
    "result": "Success"
  }
}

발신프로필 카테고리 관리

카카오 비즈메시지에서 사용하는 발신프로필 카테고리 정보를 조회하는 API입니다. 발신프로필 등록이나 운영 정책 확인 시 함께 참고합니다.

카테고리 전체조회

GET/api/comm/v1/center/kakao/sender/category/list
샌드박스로 테스트하기

발신프로필 등록 시 사용할 수 있는 카카오 비즈메시지 카테고리 목록을 조회합니다.

Returns

common

Object

공통 응답 영역입니다.

data

Object

서비스 응답 영역입니다.

요청 예시

1curl -X GET "https://mars.ibapi.kr/api/comm/v1/center/kakao/sender/category/list" \
2 -H "Authorization: {ApiKey}"

응답 예시

1{
2 "common": {
3 "authCode":"A000",
4 "authResult":"Success",
5 "infobankTrId":"Infobank-Tracking-Id"
6 },
7 "data": {
8 "code":"A000",
9 "result":"Success",
10 "data": {
11 "kakao": {
12 "categories": [
13 {
14 "code":"001",
15 "name":"쇼핑"
16 },
17 {
18 "code":"002",
19 "name":"금융"
20 }
21 ]
22 }
23 }
24 }
25}

Returns

필드타입설명
commonObject공통 응답 영역입니다.
common.authCodeString인증 결과 코드입니다.
common.authResultString인증 결과 메시지입니다.
common.infobankTrIdString트랜잭션 추적 아이디입니다.
dataObject서비스 응답 영역입니다.
data.codeString호출 결과 코드입니다.
data.resultString호출 결과 설명입니다.
data.dataObject실제 응답 데이터입니다.
data.data.kakaoObject카카오 비즈메시지 응답 데이터입니다.
data.data.kakao.categoriesObject Array카테고리 목록입니다.
data.data.kakao.categories[].codeString카테고리 코드입니다.
data.data.kakao.categories[].nameString카테고리 이름입니다.

요청 예시

Bash
curl -X GET "https://mars.ibapi.kr/api/comm/v1/center/kakao/sender/category/list" \
  -H "Authorization: {ApiKey}"
JavaScript
const res = await fetch("https://mars.ibapi.kr/api/comm/v1/center/kakao/sender/category/list", {
  method: "GET",
  headers: {
    "Authorization": "{ApiKey}"
  }
});
Python
import requests

response = requests.get(
    "https://mars.ibapi.kr/api/comm/v1/center/kakao/sender/category/list",
    headers={"Authorization": "{ApiKey}"}
)
data = response.json()
Java
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://mars.ibapi.kr/api/comm/v1/center/kakao/sender/category/list"))
    .header("Authorization", "{ApiKey}")
    .method("GET", HttpRequest.BodyPublishers.noBody())
    .build();

HttpResponse<String> response = client.send(
    request, HttpResponse.BodyHandlers.ofString()
);

응답 예시

JSON
{
  "common": {
    "authCode": "A000",
    "authResult": "Success",
    "infobankTrId": "Infobank-Tracking-Id"
  },
  "data": {
    "code": "A000",
    "result": "Success",
    "data": {
      "kakao": {
        "categories": [
          { "code": "001", "name": "쇼핑" },
          { "code": "002", "name": "금융" }
        ]
      }
    }
  }
}

카테고리 상세조회

GET/api/comm/v1/center/kakao/sender/category
샌드박스로 테스트하기

카테고리 코드를 기준으로 카카오 비즈메시지 카테고리 상세 정보를 조회합니다.

Query Parameters

code

필수String

조회할 카테고리 코드입니다.

Returns

common

Object

공통 응답 영역입니다.

data

Object

서비스 응답 영역입니다.

요청 예시

1curl -X GET "https://mars.ibapi.kr/api/comm/v1/center/kakao/sender/category?code={code}" \
2 -H "Authorization: {ApiKey}"

응답 예시

1{
2 "common": {
3 "authCode":"A000",
4 "authResult":"Success",
5 "infobankTrId":"Infobank-Tracking-Id"
6 },
7 "data": {
8 "code":"A000",
9 "result":"Success",
10 "data": {
11 "kakao": {
12 "category": {
13 "code":"001",
14 "name":"쇼핑"
15 }
16 }
17 }
18 }
19}

Query Parameters

파라미터타입필수설명
codeString✅조회할 카테고리 코드입니다.

Returns

필드타입설명
commonObject공통 응답 영역입니다.
data.data.kakaoObject카카오 비즈메시지 응답 데이터입니다.
data.data.kakao.categoryObject카테고리 상세 정보입니다.
data.data.kakao.category.codeString카테고리 코드입니다.
data.data.kakao.category.nameString카테고리 이름입니다.

요청 예시

Bash
curl -X GET "https://mars.ibapi.kr/api/comm/v1/center/kakao/sender/category?code={code}" \
  -H "Authorization: {ApiKey}"
JavaScript
const res = await fetch("https://mars.ibapi.kr/api/comm/v1/center/kakao/sender/category?code={code}", {
  method: "GET",
  headers: {
    "Authorization": "{ApiKey}"
  }
});
Python
import requests

response = requests.get(
    "https://mars.ibapi.kr/api/comm/v1/center/kakao/sender/category",
    params={"code": "{code}"},
    headers={"Authorization": "{ApiKey}"}
)
data = response.json()
Java
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://mars.ibapi.kr/api/comm/v1/center/kakao/sender/category?code={code}"))
    .header("Authorization", "{ApiKey}")
    .method("GET", HttpRequest.BodyPublishers.noBody())
    .build();

HttpResponse<String> response = client.send(
    request, HttpResponse.BodyHandlers.ofString()
);

응답 예시

JSON
{
  "common": {
    "authCode": "A000",
    "authResult": "Success",
    "infobankTrId": "Infobank-Tracking-Id"
  },
  "data": {
    "code": "A000",
    "result": "Success",
    "data": {
      "kakao": {
        "category": {
          "code": "001",
          "name": "쇼핑"
        }
      }
    }
  }
}

발신프로필 그룹 관리

발신프로필 그룹은 여러 발신프로필을 묶어서 운영할 때 사용하는 관리 단위입니다. 그룹 소속을 조회하거나 그룹에 발신프로필을 등록·제외할 때 사용합니다.

발신프로필키로 그룹 조회

GET/api/comm/v1/center/kakao/group
샌드박스로 테스트하기

발신프로필 키를 기준으로 연결된 그룹 정보를 조회합니다. senderKey를 생략하면 조회 가능한 그룹 정보를 기준으로 응답합니다.

Query Parameters

senderKey

String

조회 기준 발신프로필 키입니다.

Returns

common

Object

공통 응답 영역입니다.

data

Object

서비스 응답 영역입니다.

요청 예시

1curl -X GET "https://mars.ibapi.kr/api/comm/v1/center/kakao/group?senderKey={senderKey}" \
2 -H "Authorization: {ApiKey}"

응답 예시

1{
2 "common": {
3 "authCode":"A000",
4 "authResult":"Success",
5 "infobankTrId":"Infobank-Tracking-Id"
6 },
7 "data": {
8 "code":"A000",
9 "result":"Success",
10 "data": {
11 "kakao": {
12 "groups": [
13 {
14 "groupKey":"{groupKey}",
15 "groupName":"기본 그룹"
16 }
17 ]
18 }
19 }
20 }
21}

Query Parameters

파라미터타입필수설명
senderKeyString조회 기준 발신프로필 키입니다. 생략 시 조회 가능한 그룹 전체를 반환합니다.

Returns

필드타입설명
data.data.kakaoObject카카오 비즈메시지 응답 데이터입니다.
data.data.kakao.groupsObject Array발신프로필 그룹 목록입니다.
data.data.kakao.groups[].groupKeyString그룹 키입니다.
data.data.kakao.groups[].groupNameString그룹 이름입니다.

요청 예시

Bash
curl -X GET "https://mars.ibapi.kr/api/comm/v1/center/kakao/group?senderKey={senderKey}" \
  -H "Authorization: {ApiKey}"
JavaScript
const res = await fetch("https://mars.ibapi.kr/api/comm/v1/center/kakao/group?senderKey={senderKey}", {
  method: "GET",
  headers: {
    "Authorization": "{ApiKey}"
  }
});
Python
import requests

response = requests.get(
    "https://mars.ibapi.kr/api/comm/v1/center/kakao/group",
    params={"senderKey": "{senderKey}"},
    headers={"Authorization": "{ApiKey}"}
)
data = response.json()
Java
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://mars.ibapi.kr/api/comm/v1/center/kakao/group?senderKey={senderKey}"))
    .header("Authorization", "{ApiKey}")
    .method("GET", HttpRequest.BodyPublishers.noBody())
    .build();

HttpResponse<String> response = client.send(
    request, HttpResponse.BodyHandlers.ofString()
);

응답 예시

JSON
{
  "common": {
    "authCode": "A000",
    "authResult": "Success",
    "infobankTrId": "Infobank-Tracking-Id"
  },
  "data": {
    "code": "A000",
    "result": "Success",
    "data": {
      "kakao": {
        "groups": [
          {
            "groupKey": "{groupKey}",
            "groupName": "기본 그룹"
          }
        ]
      }
    }
  }
}

그룹에 발신프로필 등록

POST/api/comm/v1/center/kakao/group
샌드박스로 테스트하기

발신프로필 그룹에 발신프로필을 등록합니다. 그룹 키와 등록할 발신프로필 키를 함께 전달합니다.

Body Parameters

{} JSON

groupKey

필수String

발신프로필을 등록할 그룹 키입니다.

senderKey

필수String

등록할 발신프로필 키입니다. max: 40

groupName

String

그룹 이름입니다.

Returns

common

Object

공통 응답 영역입니다.

data

Object

서비스 응답 영역입니다.

요청 예시

1curl -X POST "https://mars.ibapi.kr/api/comm/v1/center/kakao/group" \
2 -H "Authorization: {ApiKey}" \
3 -H "Content-Type: application/json" \
4 -d '{
5 "groupKey": "{groupKey}",
6 "senderKey": "{senderKey}"
7 }'

응답 예시

1{
2 "common": {
3 "authCode":"A000",
4 "authResult":"Success",
5 "infobankTrId":"Infobank-Tracking-Id"
6 },
7 "data": {
8 "code":"A000",
9 "result":"Success"
10 }
11}

그룹에 발신프로필 삭제

DELETE/api/comm/v1/center/kakao/group/groupKey/{groupKey}/senderKey/{senderKey}
샌드박스로 테스트하기

발신프로필 그룹에서 특정 발신프로필을 삭제합니다.

Path Parameters

groupKey

필수String

그룹 키입니다.

senderKey

필수String

삭제할 발신프로필 키입니다.

Returns

common

Object

공통 응답 영역입니다.

data

Object

서비스 응답 영역입니다.

요청 예시

1curl -X DELETE "https://mars.ibapi.kr/api/comm/v1/center/kakao/group/groupKey/{groupKey}/senderKey/{senderKey}" \
2 -H "Authorization: {ApiKey}"

응답 예시

1{
2 "common": {
3 "authCode":"A000",
4 "authResult":"Success",
5 "infobankTrId":"Infobank-Tracking-Id"
6 },
7 "data": {
8 "code":"A000",
9 "result":"Success"
10 }
11}

Path Parameters

파라미터타입필수설명
groupKeyString✅그룹 키입니다.
senderKeyString✅삭제할 발신프로필 키입니다.

요청 예시

Bash
curl -X DELETE "https://mars.ibapi.kr/api/comm/v1/center/kakao/group/groupKey/{groupKey}/senderKey/{senderKey}" \
  -H "Authorization: {ApiKey}"
JavaScript
const res = await fetch("https://mars.ibapi.kr/api/comm/v1/center/kakao/group/groupKey/{groupKey}/senderKey/{senderKey}", {
  method: "DELETE",
  headers: {
    "Authorization": "{ApiKey}"
  }
});
Python
import requests

response = requests.delete(
    "https://mars.ibapi.kr/api/comm/v1/center/kakao/group/groupKey/{groupKey}/senderKey/{senderKey}",
    headers={"Authorization": "{ApiKey}"}
)
data = response.json()
Java
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://mars.ibapi.kr/api/comm/v1/center/kakao/group/groupKey/{groupKey}/senderKey/{senderKey}"))
    .header("Authorization", "{ApiKey}")
    .method("DELETE", HttpRequest.BodyPublishers.noBody())
    .build();

HttpResponse<String> response = client.send(
    request, HttpResponse.BodyHandlers.ofString()
);

응답 예시

JSON
{
  "common": {
    "authCode": "A000",
    "authResult": "Success",
    "infobankTrId": "Infobank-Tracking-Id"
  },
  "data": {
    "code": "A000",
    "result": "Success"
  }
}

제재 관리

제재는 카카오 비즈메시지 운영정책 위반, 스팸·어뷰징 의심, 카카오톡 채널 상태 등에 따라 발신프로필이나 템플릿 단위로 메시지 발송이 제한되는 상태입니다. 제재가 적용되면 메시지 발송이 불가하거나 일부 발송 기능이 제한될 수 있으므로, 발송 전 운영 상태를 확인할 때 제재 조회 API를 사용합니다.

  • 발신프로필 제재 조회: 특정 발신프로필에 적용된 제재 정보를 확인합니다.
  • 그룹템플릿 발신프로필 제외 조회: 그룹템플릿에서 특정 발신프로필이 제외 또는 제한된 정보를 확인합니다.
  • 템플릿 제재 조회: 특정 템플릿에 적용된 제재 정보를 확인합니다.

발신프로필 제재 조회

GET/api/comm/v1/center/kakao/abusing/block/sender
샌드박스로 테스트하기

특정 일자의 발신프로필 제재 정보를 조회합니다.

Query Parameters

date

필수String

조회 기준 날짜입니다.

senderKey

필수String

발신프로필 키입니다.

Returns

common

Object

공통 응답 영역입니다.

data

Object

서비스 응답 영역입니다.

요청 예시

1curl -X GET "https://mars.ibapi.kr/api/comm/v1/center/kakao/abusing/block/sender?date={date}&senderKey={senderKey}" \
2 -H "Authorization: {ApiKey}"

응답 예시

1{
2 "common": {
3 "authCode":"A000",
4 "authResult":"Success",
5 "infobankTrId":"Infobank-Tracking-Id"
6 },
7 "data": {
8 "code":"A000",
9 "result":"Success",
10 "data": {
11 "kakao": {
12 "abusing": {
13 "restrictedAt":"2026-03-05 16:33:17",
14 "senderKey":"{senderKey}",
15 "templateCode":"{templateCode}",
16 "groupKey":"{groupKey}",
17 "senderKeyType":"S",
18 "reasonType":"BZM"
19 }
20 }
21 }
22 }
23}

Query Parameters

파라미터타입필수설명
dateString✅조회 기준 날짜입니다. example: 20260305
senderKeyString✅발신프로필 키입니다.

Returns

필드타입설명
data.data.kakaoObject카카오 비즈메시지 응답 데이터입니다.
data.data.kakao.abusingObject제재 정보입니다.
data.data.kakao.abusing.restrictedAtString제재 적용 시각입니다.
data.data.kakao.abusing.senderKeyString발신프로필 키입니다.
data.data.kakao.abusing.templateCodeString템플릿 코드입니다.
data.data.kakao.abusing.groupKeyString발신프로필 그룹 키입니다.
data.data.kakao.abusing.senderKeyTypeString발신프로필 키 타입입니다.
G: 그룹, S: 발신프로필
data.data.kakao.abusing.reasonTypeString제재 사유입니다.
BZM: 비즈메시지 운영정책위반(스팸/어뷰징), CHANNEL: 채널 운영정책위반

요청 예시

Bash
curl -X GET "https://mars.ibapi.kr/api/comm/v1/center/kakao/abusing/block/sender?date={date}&senderKey={senderKey}" \
  -H "Authorization: {ApiKey}"
JavaScript
const res = await fetch("https://mars.ibapi.kr/api/comm/v1/center/kakao/abusing/block/sender?date={date}&senderKey={senderKey}", {
  method: "GET",
  headers: {
    "Authorization": "{ApiKey}"
  }
});
Python
import requests

response = requests.get(
    "https://mars.ibapi.kr/api/comm/v1/center/kakao/abusing/block/sender",
    params={"date": "{date}", "senderKey": "{senderKey}"},
    headers={"Authorization": "{ApiKey}"}
)
data = response.json()
Java
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://mars.ibapi.kr/api/comm/v1/center/kakao/abusing/block/sender?date={date}&senderKey={senderKey}"))
    .header("Authorization", "{ApiKey}")
    .method("GET", HttpRequest.BodyPublishers.noBody())
    .build();

HttpResponse<String> response = client.send(
    request, HttpResponse.BodyHandlers.ofString()
);

응답 예시

JSON
{
  "common": {
    "authCode": "A000",
    "authResult": "Success",
    "infobankTrId": "Infobank-Tracking-Id"
  },
  "data": {
    "code": "A000",
    "result": "Success",
    "data": {
      "kakao": {
        "abusing": {
          "restrictedAt": "2026-03-05 16:33:17",
          "senderKey": "{senderKey}",
          "templateCode": "{templateCode}",
          "groupKey": "{groupKey}",
          "senderKeyType": "S",
          "reasonType": "BZM"
        }
      }
    }
  }
}

그룹템플릿 발신프로필 제외 조회

GET/api/comm/v1/center/kakao/abusing/block/senderGroup
샌드박스로 테스트하기

그룹템플릿에서 특정 발신프로필이 제외된 제재 정보를 조회합니다.

Query Parameters

date

필수String

조회 기준 날짜입니다.

senderKey

필수String

발신프로필 키입니다.

groupKey

필수String

그룹 발신프로필 키입니다.

templateCode

필수String

템플릿 코드입니다.

Returns

common

Object

공통 응답 영역입니다.

data

Object

서비스 응답 영역입니다.

요청 예시

1curl -X GET "https://mars.ibapi.kr/api/comm/v1/center/kakao/abusing/block/senderGroup?date={date}&senderKey={senderKey}&groupKey={groupKey}&templateCode={templateCode}" \
2 -H "Authorization: {ApiKey}"

응답 예시

1{
2 "common": {
3 "authCode":"A000",
4 "authResult":"Success",
5 "infobankTrId":"Infobank-Tracking-Id"
6 },
7 "data": {
8 "code":"A000",
9 "result":"Success",
10 "data": {
11 "kakao": {
12 "abusing": {
13 "restrictedAt":"2026-03-05 16:33:17",
14 "senderKey":"{senderKey}",
15 "templateCode":"{templateCode}",
16 "groupKey":"{groupKey}",
17 "senderKeyType":"S",
18 "reasonType":"BZM"
19 }
20 }
21 }
22 }
23}

Query Parameters

파라미터타입필수설명
dateString✅조회 기준 날짜입니다. example: 20260305
senderKeyString✅발신프로필 키입니다.
groupKeyString✅그룹 발신프로필 키입니다.
templateCodeString✅템플릿 코드입니다.

요청 예시

Bash
curl -X GET "https://mars.ibapi.kr/api/comm/v1/center/kakao/abusing/block/senderGroup?date={date}&senderKey={senderKey}&groupKey={groupKey}&templateCode={templateCode}" \
  -H "Authorization: {ApiKey}"
JavaScript
const res = await fetch("https://mars.ibapi.kr/api/comm/v1/center/kakao/abusing/block/senderGroup?date={date}&senderKey={senderKey}&groupKey={groupKey}&templateCode={templateCode}", {
  method: "GET",
  headers: {
    "Authorization": "{ApiKey}"
  }
});
Python
import requests

response = requests.get(
    "https://mars.ibapi.kr/api/comm/v1/center/kakao/abusing/block/senderGroup",
    params={"date": "{date}", "senderKey": "{senderKey}", "groupKey": "{groupKey}", "templateCode": "{templateCode}"},
    headers={"Authorization": "{ApiKey}"}
)
data = response.json()
Java
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://mars.ibapi.kr/api/comm/v1/center/kakao/abusing/block/senderGroup?date={date}&senderKey={senderKey}&groupKey={groupKey}&templateCode={templateCode}"))
    .header("Authorization", "{ApiKey}")
    .method("GET", HttpRequest.BodyPublishers.noBody())
    .build();

HttpResponse<String> response = client.send(
    request, HttpResponse.BodyHandlers.ofString()
);

응답 예시

JSON
{
  "common": {
    "authCode": "A000",
    "authResult": "Success",
    "infobankTrId": "Infobank-Tracking-Id"
  },
  "data": {
    "code": "A000",
    "result": "Success",
    "data": {
      "kakao": {
        "abusing": {
          "restrictedAt": "2026-03-05 16:33:17",
          "senderKey": "{senderKey}",
          "templateCode": "{templateCode}",
          "groupKey": "{groupKey}",
          "senderKeyType": "S",
          "reasonType": "BZM"
        }
      }
    }
  }
}

템플릿 제재 조회

GET/api/comm/v1/center/kakao/abusing/block/template
샌드박스로 테스트하기

특정 템플릿의 제재 정보를 조회합니다.

Query Parameters

date

필수String

조회 기준 날짜입니다.

senderKey

필수String

발신프로필 키입니다.

templateCode

필수String

템플릿 코드입니다.

Returns

common

Object

공통 응답 영역입니다.

data

Object

서비스 응답 영역입니다.

요청 예시

1curl -X GET "https://mars.ibapi.kr/api/comm/v1/center/kakao/abusing/block/template?date={date}&senderKey={senderKey}&templateCode={templateCode}" \
2 -H "Authorization: {ApiKey}"

응답 예시

1{
2 "common": {
3 "authCode":"A000",
4 "authResult":"Success",
5 "infobankTrId":"Infobank-Tracking-Id"
6 },
7 "data": {
8 "code":"A000",
9 "result":"Success",
10 "data": {
11 "kakao": {
12 "abusing": {
13 "restrictedAt":"2026-03-05 16:33:17",
14 "senderKey":"{senderKey}",
15 "templateCode":"{templateCode}",
16 "groupKey":"{groupKey}",
17 "senderKeyType":"S",
18 "reasonType":"CHANNEL"
19 }
20 }
21 }
22 }
23}

Query Parameters

파라미터타입필수설명
dateString✅조회 기준 날짜입니다. example: 20260305
senderKeyString✅발신프로필 키입니다.
templateCodeString✅템플릿 코드입니다.

요청 예시

Bash
curl -X GET "https://mars.ibapi.kr/api/comm/v1/center/kakao/abusing/block/template?date={date}&senderKey={senderKey}&templateCode={templateCode}" \
  -H "Authorization: {ApiKey}"
JavaScript
const res = await fetch("https://mars.ibapi.kr/api/comm/v1/center/kakao/abusing/block/template?date={date}&senderKey={senderKey}&templateCode={templateCode}", {
  method: "GET",
  headers: {
    "Authorization": "{ApiKey}"
  }
});
Python
import requests

response = requests.get(
    "https://mars.ibapi.kr/api/comm/v1/center/kakao/abusing/block/template",
    params={"date": "{date}", "senderKey": "{senderKey}", "templateCode": "{templateCode}"},
    headers={"Authorization": "{ApiKey}"}
)
data = response.json()
Java
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://mars.ibapi.kr/api/comm/v1/center/kakao/abusing/block/template?date={date}&senderKey={senderKey}&templateCode={templateCode}"))
    .header("Authorization", "{ApiKey}")
    .method("GET", HttpRequest.BodyPublishers.noBody())
    .build();

HttpResponse<String> response = client.send(
    request, HttpResponse.BodyHandlers.ofString()
);

응답 예시

JSON
{
  "common": {
    "authCode": "A000",
    "authResult": "Success",
    "infobankTrId": "Infobank-Tracking-Id"
  },
  "data": {
    "code": "A000",
    "result": "Success",
    "data": {
      "kakao": {
        "abusing": {
          "restrictedAt": "2026-03-05 16:33:17",
          "senderKey": "{senderKey}",
          "templateCode": "{templateCode}",
          "groupKey": "{groupKey}",
          "senderKeyType": "S",
          "reasonType": "CHANNEL"
        }
      }
    }
  }
}