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.

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"
      }
    }