vtex.local – Subscriptions-API-(v3)
A Subscription is a list of items (SKUs) tied to certain recurring purchase settings:
- User profile
- Address
- Payment method
- Frequency
- Cycle
Once you have in your store, the Subscriptions API allows you to create, manage and monitor your customers' subscriptions.

To read more about the Subscriptions feature, check our article .
- Homepage
- https://api.apis.guru/v2/specs/vtex.local:Subscriptions-API-(v3)/1.0.json
- Provider
- vtex.local:Subscriptions-API-(v3) / Subscriptions-API-(v3)
- OpenAPI version
- 3.0.0
- Spec (JSON)
- https://api.apis.guru/v2/specs/vtex.local/Subscriptions-API-(v3)/1.0/openapi.json
- Spec (YAML)
- https://api.apis.guru/v2/specs/vtex.local/Subscriptions-API-(v3)/1.0/openapi.yaml
Tools (22)
Extracted live via the executor SDK.
-
cycles.getApiRnsPubCyclesList cycles filtering by some arguments.
-
cycles.getApiRnsPubCyclesCycleIdRetrieve a specific cycle by its ID.
-
cycles.postApiRnsPubCyclesCycleIdRetryEvery subscription order has an execution count called cycle, which determines the position of an order counting from when the shopper subscribed. This endpoint reruns a cycle that is currently in error state.
-
plans.getApiRnsPvtPlansList plans filtering by some arguments.
-
plans.getApiRnsPvtPlansIdThis endpoint retrieves a specific plan by its ID.
-
reports.getApiRnsPvtReportsList all report templates available.
-
reports.getApiRnsPvtReportsReportNameDocumentsDocumentIdRetrieve a specific report document by its Id.
-
reports.postApiRnsPvtReportsReportNameDocumentsThis endpoint creates a new report in the format of a CSV file and sends it via email. You can generate one of the following reports:
-
subscriptionsWithStatus
-
subscriptionsScheduledBetweenDate
-
subscriptionsUpdatedBetweenDate
-
subscriptionsCreatedBetweenDate
-
executionsBetweenDate
-
-
settings.editSettingsEdits Subscriptions settings in your store.
-
settings.getSettingsList the details of the settings of a given subscription.
-
subscriptions.deleteApiRnsPubSubscriptionsIdItemsItemIdRemoves a specific item from a given subscription
-
subscriptions.getApiRnsPubSubscriptionsList subscriptions filtering by some arguments.
-
subscriptions.getApiRnsPubSubscriptionsIdRetrieve a specific subscription by its ID.
-
subscriptions.getApiRnsPubSubscriptionsSubscriptionIdConversationMessageRetrieve all conversation messages sent to a customer regarding a given subscription.
-
subscriptions.patchApiRnsPubSubscriptionsIdUpdate a specific subscription.
-
subscriptions.patchApiRnsPubSubscriptionsIdItemsItemIdEdit a given item on a specific subscription
-
subscriptions.postApiRnsPubSubscriptionsCreate a new subscription.
-
subscriptions.postApiRnsPubSubscriptionsIdItemsAdd a new item to a given subscription.
-
subscriptions.postApiRnsPubSubscriptionsIdSimulateSimulates an order made by the specific subscription on checkout and retrieves the current price for items and shipping.
-
subscriptions.postApiRnsPubSubscriptionsSimulateSimulates an order made by subscriptions on checkout and retrieves the current price for items and shipping.
-
openapi.previewSpecPreview an OpenAPI document before adding it as a source
-
openapi.addSourceAdd an OpenAPI source and register its operations as tools