Verify a subscriber

GET

/storefronts/{storefront_id}/subscribers/verify

const url = 'https://api.getdpd.com/v2/storefronts/1/subscribers/verify?username=test%40example.com';
const options = {method: 'GET', headers: {Authorization: 'Basic <credentials>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url 'https://api.getdpd.com/v2/storefronts/1/subscribers/verify?username=test%40example.com' \
  --header 'Authorization: Basic <credentials>'

Returns just the subscriber’s subscription status, as plain text. Pass id or username. Subscribers with ACTIVE, TRIAL or PAST_DUE should get service.

Authorizations

basicAuth

Parameters

Path Parameters

storefront_id

required

integer

Query Parameters

username

string

The subscriber’s username (their email address).

Example

test@example.com

integer

The subscriber ID. Used instead of username when both are given.

Responses

200

The subscription status.

text/plain

NEW Not activated yet: checking out, or abandoned signup.
TRIAL In the trial period.
ACTIVE Active, no payment due.
CANCELED Canceled, but the current term hasn’t ended.
CLOSED Canceled and closed.
PAST_DUE Active, but a payment is overdue. Closes if it isn’t paid.

string

Allowed values: NEW TRIAL ACTIVE CANCELED CLOSED PAST_DUE

401

The username or API password is wrong.

404

Nothing found: the record doesn’t exist or isn’t yours, the list is empty, or the page is past the last one.

application/json

object

status

string

Allowed value: NOTFOUND

Example

{
  "status": "NOTFOUND"
}