---
title: "셀러 페널티 요약 조회"
method: GET
path: "/api/v3/shopping-fep/merchants/penalty/summary"
tags: ["셀러"]
---

# 셀러 페널티 요약 조회

`GET /api/v3/shopping-fep/merchants/penalty/summary`

셀러의 페널티 현황을 요약하여 조회합니다.

## 응답 필드

- `score`: 현재 누적된 페널티 점수입니다.

- `count`: 페널티가 부과된 건수입니다.

- `isPenalized`: 현재 페널티가 적용 중인지 여부입니다.

## Query parameters

- `partnerName` string

## Response `200`

모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)

- object
  - `resultType` 'SUCCESS' | 'FAIL' — 응답 결과 타입
  - `error` object — 에러 응답, resultType FAIL 시 제공
    - `errorCode` 'REQUEST_FAILED' | 'COMMON_ERROR' — 에러 코드
    - `reason` string — 에러 사유
  - `success` MerchantPenaltySummaryFepResponse — 셀러 페널티 요약 응답
    - `score` integer, required — 페널티 점수
    - `count` integer, required — 페널티 건수
    - `isPenalized` boolean, required — 페널티 적용 여부

---

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