Get subscribers

Returns a list of subscribers, could paginated using the page and limit query parameter

Java

import co.novu.common.base.Novu;
import co.novu.api.subscribers.responses.BulkSubscriberResponse;

public class Main {
   public static void main(String[] args) {
        String apiKey = "<NOVU_API_KEY>";
        Novu novu = new Novu(apiKey);

        Integer page = 0;
        Integer limit = 10;

        BulkSubscriberResponse response = novu.getSubscribers(page, limit);
    }
}

Response

{
  "data": [
    {
      "__v": "number",
      "_environmentId": "string",
      "_id": "string",
      "_organizationId": "string",
      "avatar": "string",
      "channels": [
        {
          "_integrationId": "string",
          "credentials": {
            "channel": "string",
            "deviceTokens": [
              "string"
            ],
            "webhookUrl": "string"
          },
          "integrationIdentifier": "string",
          "providerId": "slack"
        }
      ],
      "createdAt": "string",
      "deleted": "boolean",
      "email": "string",
      "firstName": "string",
      "isOnline": "boolean",
      "lastName": "string",
      "lastOnlineAt": "string",
      "locale": "string",
      "phone": "string",
      "subscriberId": "string",
      "updatedAt": "string"
    }
  ],
  "hasMore": "boolean",
  "page": "number",
  "pageSize": "number"
}

Query Parameters

page · number

limit · number · default: 10

Required range: x <= 100

Response

200

application/json

page · number · required

The current page of the paginated response

hasMore · boolean · required

Does the list have more items to fetch

pageSize · number · required

Number of items on each page

data · object[] · required

The list of items matching the query

Show child attributes