Subscriptions are objects that are created when a buyer subscribes to a subscription product.

You can use this endpoint to verify the existence and status of a subscription or multiple subscriptions.

Endpoint

GET /subscriptions/verify

Required parameters

• email - The email address of the subscriber

Example request

  
    curl https://api.zylvie.com/subscriptions/verify \
      -h "Authorization: Bearer e97f0aafe4884bc380c81fdb2347dc55" \
      -d "email=stavros@greek.com" \
  

Example response

  
    [
      {
        "subscription_id": "sub_1PMbcsF18w81dttLRCKt2MRI", //Stripe subscription ID
        "created_at": "2025-03-23T03:12:35Z",
        "cancel_at": "2026-05-13T03:12:35Z", //Date and time subscription is scheduled to cancel
        "canceled_at": "2026-05-29T03:12:35Z", //Date and time subscription was actually cancelled
        "trial_end": "2025-03-30T03:12:35Z",
        "trial_start": "2025-03-23T03:12:35Z",
        "currency": "usd",
        "amount": 1995, //cents, or smallest unit of currency
        "interval": "month", //Possible values are day, week, month, or year.
        "interval_count": 1, //1 with interval "month" means monthly
        "status": "active", //Possible values are incomplete, incomplete_expired, trialing, active, past_due, canceled, or unpaid.
        "product": {
          "title": "Basic Plan",
        },
        "subscriber": {
          "name": "Stavros Flatley",
          "email": "stavros@greek.com",
          "phone": "+353850163326",
          "line1": "349 Navan Road",
          "line2": "Ashtown",
          "postal_code": "D07 R2C3",
          "city": "Dublin 7",
          "state": "County Dublin",
          "country": "IE",
          "payment_method_type": "card",
          "card_brand": "visa",
          "card_last4": "0005"
        }
      }
    ]