GET https://api.usecommune.com/subscriptions Production. There is no separate sandbox host.

List the newsletters this account subscribes to

Every newsletter this account is subscribed to, most recently subscribed first.

Needs account: read, which either an API key or an OAuth token can carry. A row can name a newsletter no other operation will let this credential address, and says nothing about it beyond an identifier.

Only live subscriptions appear. Commune keeps the record when somebody leaves and moves its status instead, so an unsubscribed, bounced or complained record is not returned here.

A subscription Commune learned from a newsletter's email provider is returned beside one made in Commune. What is not returned is the half of that record belonging to the newsletter rather than to the reader: the address the provider held, the provider's own identifier for this person, the tags the newsletter has applied, and how they were acquired.

Read the page as Commune's record of what this person reads rather than a complete one. Commune's subscriber records are a partial cache of each newsletter's provider list, so a newsletter whose provider is not connected to Commune is missing from it, and an unsubscribe made at the provider can take until the next reconciliation to disappear.

newsletter is a reference, and ?expand=newsletter replaces it with a NewsletterSummary, under the rules GET /memberships sets out.

Query parameters

  • string
  • integer
  • string
  • string

Request Headers

  • string
GET /subscriptions
Loading...

Share your request

Use this link to easily share a pre-filled request of this operation. Everything you filled will be shared apart from the authentication fields.

Request URL

https://api-reference.usecommune.dev/explorer/operation/operation-listsubscriptions

Send a delete request

It looks like you’re about to send a DELETE request to this API. This type of request carries a risk of permanent and irreversible data loss.

Are you sure you want to continue?
Response
Waiting for a request to be sent.