# Subscription

A subscription is a recurring payment.
The client authorizes a transaction at regular intervals, such as weekly, monthly, or annually.
Examples include mortgages, leases, streaming media payments, and Insurance premiums.
Payments represent:
* **Recurring billing**. The transaction happens automatically on a set schedule without the client having to re-enter payment details.
* **Pre-authorization**. The customer approves transactions for future charges.
* **Fixed or variable amounts**. The transaction can be the same every cycle, such as for a streaming service or vary based on usage, such as a utility bill.
* **Stored payment**. The transaction uses a vault or stored payment method.
Payment methods include a credit or debit card (only sale transactions) and ACH electronic check.

Installments may be specified as a combination of:
* Days of the month, such as the 1st, 15th, or 30th
* Weeks of the month, such as the first week or the third week
* Months, such as 1 (January), 3 (March), or 12 (December)

Installments may either specify:
* A set number of payments, such as 36, 60, 360.
For example, this may be for a mortgage or car payment.
* Be indefinite and not specify an end date or a number of payments.
For example, this may be for a streaming media subscription.

The following endpoints are available:
`GET /sub-api/v1/subscriptions`
Lists subscriptions associated with the merchant.
`GET /sub-api/v1/subscriptions/{{subscriptionId}}`
Lists subscriptions associated with a specified subscription identifier.
`POST /sub-api/v1/subscriptions`
Creates a subscription.
`GET /sub-api/v1/subscriptions/{{subscriptionId}}/payments`
Lists the payment history from a specified subscription identifier.
`PUT /sub-api/v1/subscriptions/{{subscriptionId}}/terminate`
Terminate or cancels the specified subscription identifier.

 - [GET /sub-api/v1/subscriptions](https://developer.flute.com/api-reference/subscription/sub_api_v1_list_subscriptions.md): GET {{baseURL}}/sub-api/v1/subscriptions This endpoint returns a list of the merchant's subscriptions. See Also: To create a subscription, see POST /sub-api/v1/subscriptions. To retrieve a subscriptio
 - [POST /sub-api/v1/subscriptions](https://developer.flute.com/api-reference/subscription/sub_api_v1_create_subscriptions.md): POST {{baseURL}}/sub-api/v1/subscriptions This endpoint creates a subscription. A subscription is a recurring payment. The client authorizes a transaction at regular intervals, such as weekly, monthly
 - [GET /sub-api/v1/subscriptions/{subscriptionId}](https://developer.flute.com/api-reference/subscription/flute-v1-get-sub-api-subscriptions-subscriptionid.md): GET {{baseURL}}/sub-api/v1/subscriptions/{subscriptionId} This endpoint retrieves a specified subscription. See Also: To list a merchant's subscriptions, see GET /sub-api/v1/subscriptions. To create a
 - [GET /sub-api/v1/subscriptions/{subscriptionId}/payments](https://developer.flute.com/api-reference/subscription/flute-v1-get-sub-api-subscriptions-subscriptionid-payments.md): GET {{baseURL}}/sub-api/v1/subscriptions/{{subscriptionId}}/payments This endpoint retrieves a history of payments for a specified subscription. See Also: To list a merchant's subscriptions, see GET /
 - [PUT /sub-api/v1/subscriptions/{subscriptionId}/terminate](https://developer.flute.com/api-reference/subscription/flute-v1-put-sub-api-subscriptions-subscriptionid-terminate.md): PUT {{baseURL}}/sub-api/v1/subscriptions/{{subscriptionId}}/terminate This endpoint terminates, or cancels, an active subscription. This action occurs immediately and cannot be undone. See Also: To li