Sign in

v1

latestOpenAPI 3.0.12026-07-242871595.3 MB
PLANS

Get a plan

Retrieves a specific plan based on the planId . Each plan defines a fixed amount, periodic frequency, tax, convenience fees, tips, and so on. You can create as many recurring payment plans as required.

get/v1/plans/{planId}

Path parameters

planIdstring required

Universally unique identifier (UUID) of a plan.

Headers

X-Clover-Merchant-Idstring required

Clover merchant identifier (mId).

Content-Typestring

Content Type

User-Agentstring required

Identifies the application, operating system, vendor, and/or version of the requesting user agent. Format: <application>/<version>

Response

Successful response. Specific merchant plan is displayed.

idstring

Plan identifier.

namestring

Plan name.

merchantIdstring

Merchant identifier.

taxRateUuidsstring[]

Tax rate universally unique identifiers (UUIDs).

tipAmountstring

Tip amount.

amountstring

Plan amount.

activeboolean

Indicates whether the plan is active. Values:

  • True
  • False
interval'DAY' | 'MONTH' | 'WEEK' | 'YEAR'

Plan interval. Example: Daily, weekly, semi-monthly, monthly, quarterly, yearly. See Interval Matrix table for details.

intervalCountinteger

Number of times the plan interval occurs.

productUuidstring

Product universally unique identifier (UUID).

notestring

Additional information or note related to the plan.

createdTimestring date-time

Time when the plan was created.

modifiedTimestring date-time

Time when the plan was modified.

deletedTimestring date-time

Time when the plan was deleted.

subscriptionCountinteger

Number of subscriptions in the plan.

subscriptionPaidTotalAmountinteger

Total paid amount for subscriptions in the plan.

lastRunDatestring date-time

Last run date for the plan.

objectstring

Example response

{
  "note": "note",
  "modifiedTime": "2000-01-23T04:56:07.000Z",
  "amount": "amount",
  "tipAmount": "tipAmount",
  "subscriptionCount": 6,
  "active": true,
  "lastRunDate": "2000-01-23T04:56:07.000Z",
  "taxRateUuids": [
    "taxRateUuids",
    "taxRateUuids"
  ],
  "productUuid": "productUuid",
  "merchantId": "merchantId",
  "subscriptionPaidTotalAmount": 1,
  "intervalCount": 0,
  "name": "name",
  "createdTime": "2000-01-23T04:56:07.000Z",
  "interval": "DAY",
  "id": "id",
  "deletedTime": "2000-01-23T04:56:07.000Z",
  "object": "object"
}