---
search:
  tags:
    - administration
    - GET
seo:
  description: >-
    What is Subscription Status? Subscription Status provides… Reference for the
    GET /administration/subscription-status endpoint in the Leadtime Public API
    API.
sidebar:
  badge: GET
  label: Get workspace subscription and billing status
title: Get workspace subscription and billing status
type: openapi-operation
---
**What is Subscription Status?**
Subscription Status provides comprehensive information about your workspace subscription, billing details, and payment information. This endpoint returns all data needed to display subscription management interfaces, including current plan details, upcoming invoices, payment history, and feature availability.

**What data is returned:**

**Core Subscription Information:**
- **billingMode**: The workspace billing tier (free, regular, or enterprise)
- **billingStatus**: Current subscription status (active, trialing, canceled, etc.)
- **planCode**: The specific plan identifier
- **billingInterval**: Billing frequency (monthly or yearly)
- **features**: List of enabled workspace features
- **featuresInfo**: Detailed feature information with pricing for each enabled feature

**Stripe Integration:**
- **stripeCustomerId**: Stripe customer identifier (null for free workspaces)
- **stripeSubscriptionId**: Stripe subscription identifier (null for free workspaces)
- **hasPaymentMethod**: Whether a payment method is on file

**Trial Information:**
- **trialEnd**: End date of trial period (null if not in trial)

**Subscription Details** (Enterprise workspaces only):
- **status**: Current subscription status from Stripe
- **currentPeriodStart/End**: Current billing period dates
- **items**: List of subscription items with product names, quantities, and pricing
- **dashboardUrl**: Direct link to Stripe dashboard for this subscription

**Invoice Information** (Paid workspaces only):
- **nextInvoice**: Preview of upcoming invoice with:
  - Line items with descriptions and quantities
  - Subtotal, tax, and total amounts
  - Tax breakdown by rate
  - Due date
- **latestInvoices**: Up to 5 most recent invoices with:
  - Invoice number and status
  - Amount and currency
  - Payment dates and due dates
  - Direct links to view invoices

**Seat Management:**
- **billableUsersCount**: Current number of billable users
- **committedSeats**: Seats currently committed for billing
- **pendingSeats**: Seats scheduled to be added in next period
- **pendingEffectiveAt**: When pending seats become effective

**Cancellation Information:**
- **cancelAtPeriodEnd**: Whether subscription will cancel at period end
- **cancellationEffectiveAt**: When cancellation becomes effective
- **cancellationRequestedAt**: When cancellation was requested
- **cancellationReason**: Reason provided for cancellation

**Billing Interval Changes:**
- **nextBillingInterval**: Scheduled billing interval change (if any)
- **billingIntervalChangeScheduled**: When the change takes effect
- **stillAvailableFeatures**: Features that remain available after interval change

**Important Notes:**
- This is a read-only endpoint - it does not modify subscription state
- Free workspaces return basic information without Stripe details
- Enterprise workspaces include detailed Stripe subscription information
- Trial workspaces may have limited invoice history
- All monetary amounts are in cents (divide by 100 for display)
- Dates are returned in ISO 8601 format

<Operation source="api-reference" id="subscriptionstatuscontroller-getsubscriptionstatus" />