---
title: "Get the deliverability score"
method: GET
path: "/deliverability"
tags: ["Account"]
---

# Get the deliverability score

`GET /deliverability`

## Request

- Base URL: `https://api.mepmail.dev`
- URL: `https://api.mepmail.dev/deliverability`
- Auth: HTTP bearer

Returns the account's deliverability score over the trailing 30 days.

## Response `200`

Account deliverability score over the trailing 30 days

- DeliverabilityResponse
  - `object` 'deliverability', required
  - `score` number, nullable, required
  - `band` 'excellent' | 'good' | 'needs_attention' | 'at_risk' | 'null', nullable, required
  - `content_score` number, nullable, required
  - `outcome_score` number, nullable, required
  - `complaint_rate` number, required
  - `hard_bounce_rate` number, required
  - `emails_sent` integer, required
  - `scored_recipients` integer, required
  - `window_days` integer, required
  - `insufficient_outcome_data` boolean, required
  - `guardrail_status` 'ok' | 'warning' | 'paused', required
  - `score_version` integer, required

## Other responses

- `401`: Missing, malformed or invalid API key
- `403`: Restricted API key
- `429`: Rate limit exceeded: 600 requests per minute per API key and 3,000 per team; wait for Retry-After

---

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