---
title: Subscriptions Overview
slug: subscriptions-overview
docTags: 
createdAt: 2026-02-13T04:24:48.842Z
---

In the Nue Self-Service API, **Subscriptions** represent ongoing contractual relationships between customers and your business. Subscriptions are created from activated orders and manage the entire lifecycle of recurring services, from initial provisioning through renewals, modifications, and eventual termination.

## What Are Subscriptions?

Subscriptions are long-term service agreements that define:

- **Service delivery terms** (what the customer receives)
- **Billing cycles and amounts** (when and how much they pay)
- **Usage limits and entitlements** (what they can access)
- **Contract duration and renewal terms** (how long the agreement lasts)
- **Modification policies** (how changes can be made)

## Core Subscription Concepts

### Subscription Lifecycle

Subscriptions progress through several key phases:

- **Creation**: Generated automatically when orders are activated
- **Active Service**: Ongoing delivery of products and services
- **Modifications**: Changes to quantity, terms, or products via change orders
- **Renewals**: Extension of service terms and commitments
- **Termination**: End of service delivery (cancellation or expiration)

### Subscription Types

The Nue platform supports various subscription models:

- **Standard Subscriptions**: Fixed-term commitments with regular billing
- **Evergreen Subscriptions**: Month-to-month services without fixed end dates
- **Trial Subscriptions**: Time-limited evaluation periods
- **Bundle Subscriptions**: Complex packages with multiple components

## Key Subscription Components

### Service Definition

Each subscription includes:

- **Product Details**: What services are being provided
- **Quantity Information**: How many units/licenses/seats
- **Pricing Structure**: Rate cards, volume discounts, promotional pricing

### Billing Configuration

Subscriptions define billing parameters:

- **Billing Frequency**: Monthly, quarterly, annual cycles
- **Payment Terms**: When payments are due
- **Tax Calculations**: Location-based tax requirements

### Contract Terms

Legal and business terms include:

- **Service Start and End Dates**: Contract duration
- **Auto-Renewal Settings**: Automatic extension policies

## Subscription Data Views

### Current Contract View

The default subscription view shows:

- **Complete subscription timeline** with all historical and future changes
- **Current service levels** and entitlements
- **Upcoming modifications** scheduled for future dates
- **Full billing history** and projected charges

**Use Cases**:

- Customer service inquiries
- Complete subscription management
- Renewal planning and negotiations
- Full contract analysis

### Snapshot View

Point-in-time subscription views show:

- **Subscription state as of a specific date**
- **What services were active** at that time
- **Billing amounts and terms** that were in effect
- **Changes that occurred** around that period

**Use Cases**:

- Live customer display of current subscription state
- Billing dispute resolution
- Compliance and regulatory reporting
- Impact analysis of changes

## Common Subscription Operations

### Retrieval Operations

- **Fetch Customer Subscriptions**: Get all subscriptions for specific customers
- **Get Subscription Details**: Retrieve complete information for individual subscriptions
- **Generate Snapshots**: Create point-in-time views for historical analysis
- **Include Related Data**: Fetch products, pricing, and change history

### Management Operations

- **Update Subscription Settings**: Modify auto-renewal and custom fields
- **Create Change Orders**: Request modifications to existing subscriptions
- **Generate Pricing Data**: Support client-side pricing engines for real-time quotes
- **Monitor Status Changes**: Track subscription health and lifecycle events

## Integration Patterns

### Customer Self-Service

Subscriptions power customer portal experiences:

- **Subscription Dashboards**: Overview of all customer services
- **Usage Monitoring**: Track consumption against entitlements
- **Modification Requests**: Self-service upgrade/downgrade capabilities
- **Billing History**: Access to invoices and payment records

### Business Operations

Subscriptions support internal business processes:

- **Revenue Recognition**: Financial reporting and accounting
- **Customer Success**: Monitoring subscription health and usage
- **Sales Operations**: Renewal forecasting and expansion opportunities
- **Support Operations**: Service delivery and issue resolution

### External System Integration

Subscriptions synchronize with:

- **CRM Systems**: Customer relationship management (Salesforce)
- **Billing Platforms**: Invoice generation and payment processing
- **Service Delivery**: Provisioning and entitlement systems
- **Analytics Platforms**: Business intelligence and reporting

## Getting Started with Subscriptions

To effectively work with subscriptions in your application:

1. **Understand subscription types** and lifecycle stages
2. **Learn retrieval patterns** for current and historical data
3. **Implement subscription management** operations
4. **Design customer experiences** around subscription data
5. **Integrate with business systems** for operational efficiency

## Next Steps

Explore the subscription implementation guides:

- **Getting Started with Subscription Management** - Learn core retrieval and management operations
- **Subscription Data Reference** - Complete field documentation and data structures
- **Advanced Subscription Workflows** - Complex scenarios and integration patterns
- **Key Considerations for Subscriptions** - Best practices and strategic guidance

Each guide builds upon the previous one, providing comprehensive coverage of subscription capabilities in the Nue Self-Service API.