---
title: "Check the deliverability of a domain"
description: "The records a receiving mailbox reads before it trusts mail from a domain, scored."
url: "https://openemail.uk/docs/api/tools/deliverability"
area: "API"
category: "Mailbox"
---

# Check the deliverability of a domain

The records a receiving mailbox reads before it trusts mail from a domain, scored.

`GET /tools/deliverability`

## GET /tools/deliverability

The records a receiving mailbox reads before it trusts mail from a domain, scored.

## Example

Needs no scope. It checks MX, SPF, DKIM at the selectors the mail provider of the domain uses, DMARC and BIMI. Each check is `pass`, `warn`, `fail` or `absent`, with a verdict and notes written to be shown to a person, and `score` weighs them into 0 to 100, graded `A` to `F`.

**curl**

```
curl "$OE/tools/deliverability?domain=acme.com" -H "$AUTH"
```

**Response**

```
{
  "object": "deliverability_report",
  "domain": "acme.com",
  "score": 92,
  "grade": "A",
  "provider": "Google Workspace",
  "checks": [
    {
      "id": "spf",
      "label": "SPF",
      "status": "pass",
      "verdict": "SPF is published and states which servers may send.",
      "record": "v=spf1 include:_spf.google.com ~all",
      "notes": []
    }
  ]
}
```

> These are the same checks as the free deliverability checker on the OpenEmail website, and they read nothing in the workspace.

## Reference

- [`GET /tools/deliverability`](https://openemail.uk/docs/api/reference/tools#get-tools-deliverability): full reference