---
title: "List subscriptions"
description: "The newsletters and mailing lists the mailbox receives, as the Subscriptions page shows them."
url: "https://openemail.uk/docs/api/subscriptions/list"
area: "API"
category: "Mailbox"
---

# List subscriptions

The newsletters and mailing lists the mailbox receives, as the Subscriptions page shows them.

`GET /subscriptions`

## GET /subscriptions

The newsletters and mailing lists the mailbox receives, as the Subscriptions page shows them.

## Example

Needs `threads:read`. A sender is a subscription when its mail carries a `List-Unsubscribe` header, with one row for each address it writes to. `status` is `active`, the default, or `unsubscribed`, `q` searches the sender, and `sort` is `recent`, `most`, `unread` or `name`.

**curl**

```
curl "$OE/subscriptions?sort=most&limit=1" -H "$AUTH"
```

**Response**

```
{
  "object": "list",
  "data": [{
    "object": "subscription",
    "id": "sub_5d2c8e17",
    "senderEmail": "news@figma.com",
    "senderName": "Figma",
    "recipient": "hello@acme.com",
    "status": "active",
    "method": "one-click",
    "linkUrl": "https://www.figma.com/unsubscribe?u=4f1c",
    "unread": 12,
    "recent": 4,
    "total": 58,
    "sinceUnsubscribed": 0,
    "lastSeenAt": "2026-10-01T07:02:41.000Z",
    "unsubscribedAt": null,
    "unsubscribedWith": null,
    "future": null
  }],
  "total": 37,
  "counts": { "active": 37, "unsubscribed": 9 },
  "hasMore": true
}
```

> `recent` counts the mail of the last 30 days, `sinceUnsubscribed` the mail that still arrived after you unsubscribed, and `future` names the rule that keeps moving its new mail, when there is one.

> `limit`, 50 unless you say otherwise and at most 200, and `offset` page through them. `total` counts every row that matches, and `counts` how many are active and how many unsubscribed.

> A key or an app limited to particular addresses lists only the subscriptions delivered to them, and `address` narrows it to one address.

## Reference

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