# Subscriptions

Retrieve subscriptions to view status, line items, and recurring billing details for your customers.

## Get subscription

 - [POST /subscriptions/get](https://api-docs.solidgate.com/api/v2/subscriptions/get-subscription.md): Returns the subscription for the provided identifier.

## List subscriptions

 - [POST /subscriptions/list](https://api-docs.solidgate.com/api/v2/subscriptions/list-subscriptions.md): Returns a paginated list of subscriptions.

## Cancel subscription

 - [POST /subscriptions/cancel](https://api-docs.solidgate.com/api/v2/subscriptions/cancel-subscription.md): Cancels the subscription immediately or schedules cancellation for the end of the current billing period.

## Update subscription

 - [POST /subscriptions/update](https://api-docs.solidgate.com/api/v2/subscriptions/update-subscription.md): Applies targeted updates to an active subscription, including updating the payment instrument, discount, description, and metadata, ending a trial period, and managing line items. For example, trial end uses an explicit mode, and line items are managed by adding, updating, and removing entries instead of full replacement. Each update is applied only when its corresponding field is present in the request.

## Subscription created

 - [POST SubscriptionCreated](https://api-docs.solidgate.com/api/v2/subscriptions/on-subscription-created.md): Webhook sent when a new subscription is created.

## Subscription updated

 - [POST SubscriptionUpdated](https://api-docs.solidgate.com/api/v2/subscriptions/on-subscription-updated.md): Webhook sent when a subscription is updated.

## Subscription scheduled for cancellation

 - [POST SubscriptionScheduledForCancellation](https://api-docs.solidgate.com/api/v2/subscriptions/on-subscription-scheduled-for-cancellation.md): Webhook sent when a subscription is scheduled for cancellation.

## Subscription cancelled

 - [POST SubscriptionCancelled](https://api-docs.solidgate.com/api/v2/subscriptions/on-subscription-cancelled.md): Webhook sent when a subscription is cancelled.

## Subscription trial activated

 - [POST SubscriptionTrialActivated](https://api-docs.solidgate.com/api/v2/subscriptions/on-subscription-trial-activated.md): Webhook sent when a subscription trial is activated.

## Subscription activated

 - [POST SubscriptionActivated](https://api-docs.solidgate.com/api/v2/subscriptions/on-subscription-activated.md): Webhook sent when a subscription is activated.

## Subscription expired

 - [POST SubscriptionExpired](https://api-docs.solidgate.com/api/v2/subscriptions/on-subscription-expired.md): Webhook sent when a subscription expires.