# Subscription

This resource represents a recurring billing agreement for a customer. Subscriptions allow businesses to automatically charge customers on a regular schedule according to a defined billing plan.

 - [Subscription](https://docs.glomo.one/api-reference/openapi/subscription/subscription.md): Schema: #/components/schemas/Subscription
 - [CreateSubscriptionResponse](https://docs.glomo.one/api-reference/openapi/subscription/createsubscriptionresponse.md): Schema: #/components/schemas/CreateSubscriptionResponse
 - [GET /subscriptions](https://docs.glomo.one/api-reference/openapi/subscription/getsubscriptions.md): Returns a list of subscriptions matching some criteria. The subscriptions are returned sorted by creation date, with the most recent subscriptions appearing first.
 - [POST /subscriptions](https://docs.glomo.one/api-reference/openapi/subscription/createsubscription.md): Creates a new subscription for a customer with specified billing plan and schedule. The subscription will be created in 'created' status and will be activated when the customer completes the first pay
 - [GET /subscriptions/{id}](https://docs.glomo.one/api-reference/openapi/subscription/getsubscriptionbyid.md): Retrieves the details of a specific subscription by its unique identifier.
 - [PATCH /subscriptions/{id}/pause](https://docs.glomo.one/api-reference/openapi/subscription/pausesubscription.md): Pauses an active subscription. While paused, the subscription will not process any payments. A paused subscription can be resumed later using the resume endpoint.
 - [PATCH /subscriptions/{id}/resume](https://docs.glomo.one/api-reference/openapi/subscription/resumesubscription.md): Resumes a paused subscription. Once resumed, the subscription will continue processing payments according to its original schedule. Only subscriptions in 'paused' status can be resumed.
 - [PATCH /subscriptions/{id}/cancel](https://docs.glomo.one/api-reference/openapi/subscription/cancelsubscription.md): Cancels a subscription. Once cancelled, the subscription will stop processing future payments. This action cannot be undone, but you can create a new subscription if needed.
 - [PATCH /subscriptions/{id}/next-payment-date](https://docs.glomo.one/api-reference/openapi/subscription/updatenextpaymentdate.md): Updates the next payment date of a subscription.
