Request Opt-In List

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.

[stg.]Optional. Use to make request in a non-production context. Refer to Environments to learn more.
<client-name>Lower case customer name associated with your API key. Look this up in Bazaarvoice Portal.
<email-type>Capitalized email type. See Notification Types.
Query String
passkeyYour public API key. Look this up in Bazaarvoice Portal.
limitOptional. Count of email address to return. Max value of 1000 is supported. Default is 1000.
offsetRequired 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"


offsetUsed to request the next set of email addresses. See the Parameters section above more more information.
emailAddressAn encrypted email address. Refer to Decrypting Email Addresses to learn how reverse the encryption.
timestampWhen the email address was added to the opt-in list.