> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chatnode.ai/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Subscriptions

## Overview

The **Get Subscriptions** action allows your AI Agent to retrieve and display customer subscriptions directly from your connected Stripe account. This is useful for quickly checking **active, canceled, or past subscriptions** without needing to log into Stripe manually.

**Example:** A user asks: **“Can you show me my active subscriptions?”**
The AI Agent fetches subscription details from Stripe and provides them in chat.

## How to Create a Get Subscriptions

### Step 1: Create a Stripe Get Subscriptions Action

1. Go to the **Actions** tab.

2. Click **List** from the left-hand menu.

3. Select **Create Action**.

<img className="block" src="https://mintcdn.com/chatnode-55/2HMEPn0IOnlaIVdX/images/server-action-one.webp?fit=max&auto=format&n=2HMEPn0IOnlaIVdX&q=85&s=2ccd092de9d1610bc9bd87cbd7ad2b97" alt="Server Action One" width="2914" height="952" data-path="images/server-action-one.webp" />

4. Under **Stripe**, choose **Get Subscriptions**.

<img className="block" src="https://mintcdn.com/chatnode-55/eWJrLh2iz-xw2TK6/images/download-file.webp?fit=max&auto=format&n=eWJrLh2iz-xw2TK6&q=85&s=375d1c87f88342938243c44da9c2a3c4" alt="Download File" width="1226" height="1516" data-path="images/download-file.webp" />

5. Enter an **Action Title** in the pop-up window (e.g., Get Subscriptions) and click **Create**.

6. You'll now see the configuration screen for subscription retrieval.

### Step 2: Basic Settings

* **Name** → Give your action a descriptive name.

  * Example: retrieveSubscriptions

* **Description** → Explain when and how the action should be triggered.

  * Example:
    Retrieve and display customer subscriptions from the connected Stripe account. Useful for showing active or past subscriptions.

This ensures the AI Agent knows what to fetch and when to use the action.

<img className="block" src="https://mintlify.s3.us-west-1.amazonaws.com/chatnode-55/images/basic-settings-cs.webp" alt="Basic Settings Cs" />

### Step 3: Subscription Retrieval

When triggered, this action retrieves subscription details such as:

* Subscription **status** (active, past\_due, canceled, unpaid, trialing).

  It's filter subscription based on status, just like invoices.

  * **active**: Subscription is currently running.
  * **canceled**: Subscription has been canceled.
  * **incomplete**: Created but not successfully paid.
  * **incomplete\_expired**: Incomplete and expired without payment.
  * **past\_due**: Payment is overdue.
  * **paused**: Subscription is temporarily paused.
  * **trialing**: Subscription is in a trial period.
  * **unpaid**: Marked as unpaid due to failed payments.

* Linked **customer information**.

* Billing cycle and renewal details.

Example Queries:

* **“Show me my current subscription.”**

* **“Do I have any past subscriptions?”**

* **“When does my subscription renew?”**

### Step 4: Enable the Action

At the top of the configuration page, toggle from **Disable → Enable** to activate the action.

Note: The Get Subscriptions action will not work in Slack or in-app chat windows.

<img className="block" src="https://mintcdn.com/chatnode-55/GvK3P8kdrjvQ2WCo/images/enable-action-gs.webp?fit=max&auto=format&n=GvK3P8kdrjvQ2WCo&q=85&s=dd5de4f78ef23d6238922429823a0795" alt="Enable Action Gs" width="1744" height="430" data-path="images/enable-action-gs.webp" />

## Example Workflow

1. User: **“Can you show me my active subscriptions?”**

2. AI Agent triggers **Stripe Get Subscriptions**.

3. Stripe returns a list of the user's active subscriptions.

4. AI Agent responds:
   **“You currently have an active subscription: Plan: Premium, Status: Active, Renewal Date: March 15, 2025.”**

With the **Stripe Get Subscriptions** action, your AI Agent can seamlessly provide subscription details to customers, improving support efficiency and reducing manual lookups.