How to get KPIs and metrics from the Sender API

Sender is an email marketing platform focused on simplicity, offering tools for creating, automating, and tracking email campaigns efficiently with a REST API giving you access to your subscribers. You can find their documentation here: Sender's API.

Contents

• Authentication
• Endpoint
• How to get your active subscribers count from Sender
• How to get your unsubscriber count from Sender

Authentication

To access Sender’s API you need to generate an token in the API access tokens section of your Sender account.

Add this as a OAUTH Bearer token to any request to gain access to the API.

Endpoint

The primary endpoint to get list statistics is

https://api.sender.net/v2/subscribers

How to get your active subscribers count from Sender

To get all contacts send a GET request to and specify the status:

https://api.sender.net/v2/subscribers

This will return an array of subscriber object with a status property:

{
  "data": [
    {
      "id": "123",
      "status": {
        "email": "active",
        "temail": "active"
      }
    }
  ],
  "links": {
    "next": "/?page=2"
  },
  "meta": {
    "current_page": 1
  }
}

Filter by those with status.email == active to get the active subscriber count.

To page through results you must append a page query parameter using meta.current_page + 1 as the value. Note that the links.next property contains an absolute URL for this purpose which is strictly speaking incorrect as the next page here should be https://api.sender.net/v2/subscribers?page=2.

How to get your unsubscriber count from Sender

To get all contacts send a GET request to and specify the status:

https://api.sender.net/v2/subscribers

This will return an array of subscriber object with a status property:

{
  "data": [
    {
      "id": "123",
      "status": {
        "email": "unsubscribed",
        "temail": "unsubscribed"
      }
    }
  ],
  "links": {
    "next": "/?page=2"
  },
  "meta": {
    "current_page": 1
  }
}

Filter by those with status.email == unsubscribed to get the unsubsciber count.

As above to page through results you must append a page query parameter using meta.current_page + 1 as the value.