---
title: "Per-contact frequency cap"
method: GET
path: "/settings/frequency-cap"
tags: ["Usage"]
---

# Per-contact frequency cap

`GET /settings/frequency-cap`

## Request

- Base URL: `https://sending.dev/api/v1`
- URL: `https://sending.dev/api/v1/settings/frequency-cap`
- Auth: HTTP bearer

Requires authentication only (any valid API key).

## Response `200`

Current frequency cap. With the cap on it includes `impact`: how many messages were dropped or deferred in the last 30 days, and how many contacts were affected.

- FrequencyCapWithImpact
  - `max` integer, nullable, required: Maximum marketing messages per contact in the window; `null` = no cap.
  - `days` integer, required: Window size in days (1-90).
  - `policy` 'skip' | 'defer', required: `skip` drops the excess message, `defer` postpones it until the window frees up.
  - `impact` object
    - `capped` integer, required
    - `deferred` integer, required
    - `contactsAffected` integer, required
    - `windowDays` integer, required

## Other responses

- `401`: Missing or invalid token.

---

[API](https://skmtc.dev/sending/apis/sending-dev-api.md) · [All operations](https://skmtc.dev/sending/apis/sending-dev-api/llms.txt) · [OpenAPI document](https://skmtc.dev/sending/apis/sending-dev-api/revisions/9fe78d2918a1?raw)