---
title: "List subscriptions by domain"
description: "One row per sender domain, so a company that writes from several addresses is one row."
url: "https://openemail.uk/docs/api/subscriptions/list-domains"
area: "API"
category: "Mailbox"
---

# List subscriptions by domain

One row per sender domain, so a company that writes from several addresses is one row.

`GET /subscriptions/domains`

## GET /subscriptions/domains

One row per sender domain, so a company that writes from several addresses is one row.

## Example

Needs `threads:read`. It takes the same `status`, `q`, `sort`, `limit`, `offset` and `address` as `GET /subscriptions`, and adds up the counts of every sender on the domain.

**curl**

```
curl "$OE/subscriptions/domains" -H "$AUTH"
```

**Response**

```
{
  "object": "list",
  "data": [
    {
      "object": "subscription_domain",
      "domain": "figma.com",
      "name": "Figma",
      "sampleEmail": "news@figma.com",
      "senders": 3,
      "unsubscribable": 2,
      "unread": 15,
      "recent": 6,
      "total": 81,
      "sinceUnsubscribed": 0,
      "lastSeenAt": "2026-10-01T07:02:41.000Z"
    }
  ],
  "total": 24,
  "counts": { "active": 24, "unsubscribed": 6 },
  "hasMore": false
}
```

> `unsubscribable` counts the senders on the domain that can be unsubscribed without a person opening a page, which are the ones `POST /subscriptions/domains/{domain}/unsubscribe` unsubscribes from.

## Reference

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