---
title: "Deliverability Summary"
method: GET
path: "/intelligence/deliverability-summary"
tags: ["Intelligence"]
---

# Deliverability Summary

`GET /intelligence/deliverability-summary`

Returns deliverability diagnosis for a team: reply rate, bounce breakdown,
placement test results, target mix (Gmail/Outlook/corporate), and recommendations.
Use for questions like "Why is my reply rate low?"

**Bounce data:** `bounce_categories` and `bounce_types` are both derived from **send/bounce
events** (`Events.bounce_category` and `Events.bounce_subtype`). Each `bounce_types[]` row
includes `category` from the event; `percentage` is the share of that subtype within its
**category bucket** (so lines under a category sum to ~100% when subtypes are fully populated).

## Query parameters

- `teamId` string, uuid, required
- `windowDays` integer

## Response `200`

Deliverability diagnosis data

- object
  - `success` boolean
  - `data` object — summary, bounce_by_provider, placement, target_mix, recommendations
  - `request_id` string

## Other responses

- `400` — Bad Request - Invalid parameters
- `401` — Unauthorized - Invalid or missing API key
- `403` — Forbidden - Access denied
- `404` — Not Found - Resource does not exist

---

[API](https://skmtc.dev/supersend/apis/supersend-api.md) · [All operations](https://skmtc.dev/supersend/apis/supersend-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/supersend/supersend-api/revisions/f0cbeaa12643/schema)