# Subscriptions

Manage billable entity subscriptions to rates

## List Subscriptions

 - [GET /subscriptions](https://docs.nelnetpay.com/apis/billing-ledger-service/subscriptions/listsubscriptions.md): List all subscriptions for the authenticated merchant.
Subscriptions link billable entities to rates with allocation configurations.

## Create Subscription

 - [POST /subscriptions](https://docs.nelnetpay.com/apis/billing-ledger-service/subscriptions/createsubscription.md): Create a new subscription linking a billable entity to a rate.

Validation: The billable entity must be associated with ALL accounts referenced
in the allocation configuration. This is validated via Profile Service.

Billing Frequency:
- DAILY - Charges generated daily
- WEEKLY - Charges generated weekly (anchorDay = day of week 1-7)
- BIWEEKLY - Charges generated every two weeks
- MONTHLY - Charges generated monthly (anchorDay = day of month 1-31)

## Get Subscription Details

 - [GET /subscriptions/{subscriptionId}](https://docs.nelnetpay.com/apis/billing-ledger-service/subscriptions/getsubscription.md): Retrieve details of a specific subscription

## Update Subscription

 - [PATCH /subscriptions/{subscriptionId}](https://docs.nelnetpay.com/apis/billing-ledger-service/subscriptions/updatesubscription.md): Update a subscription's information (partial update).

Version Tracking: Each update increments the subscription version.
Existing charges retain the version from when they were created.

## Pause Subscription

 - [POST /subscriptions/{subscriptionId}/pause](https://docs.nelnetpay.com/apis/billing-ledger-service/subscriptions/pausesubscription.md): Pause a subscription to temporarily stop charge generation

## Resume Subscription

 - [POST /subscriptions/{subscriptionId}/resume](https://docs.nelnetpay.com/apis/billing-ledger-service/subscriptions/resumesubscription.md): Resume a paused subscription

## Cancel Subscription

 - [POST /subscriptions/{subscriptionId}/cancel](https://docs.nelnetpay.com/apis/billing-ledger-service/subscriptions/cancelsubscription.md): Cancel a subscription permanently.

Note: This does not void existing charges. Use charge void endpoints for that.