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

# Get Billing Summary

> Get the merchant's plan, credit balance, and active subscription.

Returns the current plan tier, plan duration, plan expiry, status, Nova/wallet
credit balance, and the active subscription (if any). Used by app dashboards
to surface plan tier and remaining trial.

**Required scope:** `read_billing`

## Response

<ResponseField name="data" type="object">
  <Expandable title="billing">
    <ResponseField name="storeId" type="string">Merchant store ID.</ResponseField>

    <ResponseField name="plan" type="object">
      `{ type, duration, expiresAt, status }` — plan name (e.g. `Trial`,
      `Basic`, `Pro`), duration label (`monthly`/`yearly`), expiry timestamp
      and status (`active`, `expired`, `cancelled`, `trialing`).
    </ResponseField>

    <ResponseField name="credits" type="object">
      `{ nova, wallet }` — Nova AI credits and wallet balance.
    </ResponseField>

    <ResponseField name="activeSubscription" type="object | null">
      Most recent active subscription row, `null` if none.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseExample>
  ```json theme={null}
  {
    "status": 200,
    "state": "success",
    "message": null,
    "data": {
      "billing": {
        "storeId": "7374cb9e-9f9c-4041-87de-379aea6ed21a",
        "plan": {
          "type": "Trial",
          "duration": null,
          "expiresAt": "2026-02-15T18:19:04.275Z",
          "status": "expired"
        },
        "credits": { "nova": 0, "wallet": "0.00" },
        "activeSubscription": null
      }
    },
    "pagination": null
  }
  ```
</ResponseExample>