---
title: Subscriptions
description: Manage active telecommunications service subscriptions
---

A subscription is an active telecom service that a customer bought and now uses. It carries
the whole service lifecycle: the activation, the usage tracking, the billing, and the
termination or the upgrade at the end.

## Subscription entity

A subscription in the API represents:

- **Active service**: Live telecommunications service with ongoing usage and billing
- **Service configuration**: Specific service parameters, allowances, and feature settings
- **Billing relationship**: Recurring charges, usage tracking, and payment collection
- **Lifecycle management**: Service activation, modifications, suspensions, and terminations

## Key capabilities

- **Service management** — Manage active telecommunications services with configuration updates and feature changes.
- **Usage tracking** — Monitor service consumption including data usage, voice minutes, and feature utilization.
- **Billing integration** — Track recurring charges, usage-based billing, and subscription payment collection.
- **Lifecycle control** — Handle service modifications, upgrades, downgrades, suspensions, and terminations.

## Common use cases

- **Service activation** — Activate new telecommunications services following successful order completion and payment.
- **Usage monitoring** — Track customer usage patterns and service consumption for billing and analytics.
- **Service changes** — Process subscription modifications, plan changes, and feature additions or removals.
- **Account management** — Enable customer self-service for subscription management and configuration changes.

## Related resources

Subscription entities integrate with other API resources:

- **Customers**: Customer-owned subscriptions with billing and service relationships
- **Subscribers**: End users associated with specific subscription services
- **Product offerings**: Service definitions and pricing for subscription activation
- **Orders**: Subscription creation following successful order fulfillment
- **Invoices**: Recurring billing and usage charges for active subscriptions
- **Payments**: Payment collection for subscription charges and usage-based billing
- **Licenses**: Software licenses and digital services associated with subscriptions

## Next steps

- [List subscriptions](/api-reference/subscriptions.md#tag/subscriptions/GET/subscriptions) — Retrieve all subscriptions you have access to
- [Create subscription](/api-reference/subscriptions.md#tag/subscriptions/POST/subscriptions) — Create a new telecommunications subscription
- [Get subscription](/api-reference/subscriptions.md#tag/subscriptions/GET/subscriptions/{subscriptionId}) — Retrieve detailed subscription information
- [Manage subscription](/api-reference/subscriptions.md#tag/subscriptions/POST/subscriptions/{subscriptionId}/activate) — Activate, modify, or cancel subscriptions