The Loop API is a REST API with predictable, resource-oriented URLs. It accepts JSON-encoded request bodies, returns JSON-encoded responses, and uses standard HTTP response codes, authentication, and methods.
Note: Starting February 20, 2026, V1 APIs have been officially deprecated.
This guide covers the essentials of using the admin APIs and storefront APIs, including their differences, functionalities, and links to their documentation.
Loop API Overview
The Loop API is divided into two primary categories:
API Type | Purpose | Authentication |
Designed for customer-specific actions. These APIs provide a secure, isolated approach for storefront interactions. | Session token, unique to each customer, expires after 24 hours. | |
Designed for broad administrative control. These APIs let you manage all subscriptions with the necessary permissions to make changes at an administrative level. | API token with admin-level access. |
Refer to the storefront API documentation and admin API documentation for detailed information on authentication, rate limiting, and other essentials.
FAQs
Is it possible to reactivate a previously cancelled subscription with a new purchase, via the Loop API or custom implementation, while modifying the reactivated subscription's contents at the same time?
Is it possible to reactivate a previously cancelled subscription with a new purchase, via the Loop API or custom implementation, while modifying the reactivated subscription's contents at the same time?
Yes, the checkoutReactivate API lets you reactivate a cancelled subscription with new lines. If the order fails, the subscription status, i.e., cancelled, will be retained. But if the order is successful, then only the subscription will be marked as Active.
The existing lines will be removed automatically, and only the new lines will be retained.
What is the difference between the Loop Storefront API and Admin API, and where can I see the documentation for the API?
What is the difference between the Loop Storefront API and Admin API, and where can I see the documentation for the API?
The Loop storefront API lets customers view and manage their own subscriptions on the storefront. The admin API is for store admins or backend systems to fully manage all subscription data and settings. You can access the documentation for storefront API here and the documentation for admin API here
What is the difference between "DAY" and "CUSTOM" intervalType in the API?
What is the difference between "DAY" and "CUSTOM" intervalType in the API?
In all other IntervalType - you need to pass what you have selected as the default value in backed, like 1 week, 2 weeks, or so.
But in custom IntervalType - it could be based on what date the customer selects and pass the number of days.
Is it possible to setup subscriptions outside Shopify through APIs?
Is it possible to setup subscriptions outside Shopify through APIs?
No, Loop is designed to work inside Shopify only, so setting up subscriptions outside Shopify through APIs is not possible.
What is the reason behind the error "Loop integration failed, kindly check your credentials," and how can it be resolved?
What is the reason behind the error "Loop integration failed, kindly check your credentials," and how can it be resolved?
This error typically occurs due to an incorrect token or configuration. If you are adding the Loop API token to another app, share the URL details with the support team so they can review the request payload and investigate further.
How can I retrieve the last successful payment identifier using APIs while creating a subscription?
How can I retrieve the last successful payment identifier using APIs while creating a subscription?
To retrieve the last successful payment identifier using APIs, check the payment object in the relevant subscription endpoints.
You can use the lastCharged key inside the payment object to access the identifier of the last successful payment method. This helps you determine which card was most recently used when creating or managing subscriptions through the API.
Need help?
No worries - we're here for you!
If you have any questions or need assistance, feel free to email us at support@loopwork.co or chat with us using the support beacon at the bottom right of your screen.
Regards,
Loop Subscriptions team 🙂