The Bazaarvoice Notifications Subscriptions API enables you to manage end-user subscriptions to email notifications triggered by the Bazaarvoice platform. To learn more, go to the Notifications Subscriptions API home page.


(+ show- hide)

This page explains how to request a list of email addresses that have been explicitly subscribed to a particular email type.


The opt-in list for a particular email type is a list of all email addresses that have been explicitly subscribed to that email type.

Requesting email addresses is a two step process involving:

  1. Request an opt-in list of encrypted emails
  2. Decrypt the emails from step #1

This page documents step 1. For step 2 refer to Decrypting Email Addresses. Refer to the Tools page to view Open API specs and Postman collections that help you interact with the Notifications Subscriptions API.


GET https://[stg.]<client-name>/subscriptions/by_page/<email-type>/OPT_IN?passkey=<your-api-key>&limit=<limit-value>&offset=<offset-token> HTTP/1.1

Returns a paginated list of encrypted email addresses that have been added to the opt-in list for a particular email type.

Each response will include an offset value. This value should be used in subsequent requests. Continue making requests until no more email addresses are returned.


All parameters are required, unless otherwise noted.

Name Description



Optional. Use to make request in a non-production context. Refer to Environments to learn more.


Lower case customer name associated with your API key. Look this up in the Bazaarvoice Portal.


Capitalized email type. See Notifications Type.

Query String


Your public API key. Look this up in the Bazaarvoice Portal.


Optional. Count of email address to return. Max value of 1000 is supported. Default is 1000.


Required after 1st request. A token, provided in each API response, to be used in the next request.


The response to a successful request will be a JSON array of encrypted email address. The following demonstrates a typical response:

  "offset": "NTkwNDdhNmEyODgyMmNhMWYwM2Q1Mzk3",
  "data": [
      "emailAddress": "ec581595844af9ba2bb7af6d40f24419bc502dfbb7d68ff753386a509140fce9",
      "timestamp": "2017-01-06T16:47:15.082Z"
      "emailAddress": "4067bbb4da87cbd43d6c39dd6199fc034778d63a2555d0d7f1e1588aa384091f",
      "timestamp": "2017-01-06T16:47:15.082Z"


Name Description

Used to request the next set of email addresses. See the Parameters section above more more information.


An encrypted email address. Refer to Decrypting Email Addresses to learn how reverse the encryption.


When the email address was added to the opt-in list.