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

# get_subscriber_subscriptions

> Returns all subscription IDs for a given subscriber address across every merchant on Vowena. Read-only query requiring no wallet signature.

```rust theme={null}
fn get_subscriber_subscriptions(env: Env, subscriber: Address) -> Vec<u64>
```

Returns a vector of all subscription IDs associated with the given subscriber address. This includes subscriptions in any status - `Active`, `Paused`, `Cancelled`, and `Expired`. This is a read-only function - no transaction signature is required.

***

## Parameters

| Name         | Type      | Description                       |
| ------------ | --------- | --------------------------------- |
| `subscriber` | `Address` | The subscriber's Stellar address. |

***

## Authorization

None. This is a read-only query.

***

## Return value

`Vec<u64>` - a list of subscription IDs for the subscriber. Returns an empty vector if the subscriber has no subscriptions.

***

## Error cases

None. Returns an empty vector if the subscriber has no subscriptions.

***

## Examples

<Tabs>
  <Tab title="SDK">
    ```typescript theme={null}
    import { VowenaClient, NETWORKS } from "@vowena/sdk";

    const client = new VowenaClient({
      contractId: NETWORKS.mainnet.contractId,
      rpcUrl: NETWORKS.mainnet.rpcUrl,
      networkPassphrase: NETWORKS.mainnet.networkPassphrase,
    });

    const subIds = await client.getSubscriberSubscriptions("GSUBSCRIBER...ADDR");
    console.log("Subscription IDs:", subIds); // e.g., [1, 3, 7]

    // Fetch full details and filter active ones
    for (const subId of subIds) {
      const sub = await client.getSubscription(subId);
      if (sub.status === "Active") {
        console.log(`Sub ${subId}: plan ${sub.planId}, next billing ${new Date(sub.nextBillingTime * 1000)}`);
      }
    }
    ```
  </Tab>

  <Tab title="Soroban CLI">
    ```bash theme={null}
    soroban contract invoke \
      --id CONTRACT_ID \
      --network mainnet \
      -- \
      get_subscriber_subscriptions \
      --subscriber GSUBSCRIBER...ADDR
    ```
  </Tab>
</Tabs>

<Tip>
  This returns all subscriptions regardless of status. To display only active subscriptions in your UI, filter the results by checking each subscription's `status` field via [`get_subscription`](/api-reference/get-subscription).
</Tip>