Node.js
import Shoply from "@shoplygg/node";
const shoply = new Shoply({ apiKey: process.env.SHOPLY_API_KEY });
const result = await shoply.subscriptions.show("SUBSCRIPTION_ID");<?php
require 'vendor/autoload.php';
$shoply = new Shoply\Client(['apiKey' => getenv('SHOPLY_API_KEY')]);
$result = $shoply->subscriptions->show('SUBSCRIPTION_ID');
import shoply
client = shoply.Client() # reads SHOPLY_API_KEY
result = client.subscriptions.show("SUBSCRIPTION_ID")
curl --request GET \
--url https://api.shoply.gg/v1/stores/{storeId}/subscriptions/{subscriptionId} \
--header 'Authorization: Bearer <token>'package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.shoply.gg/v1/stores/{storeId}/subscriptions/{subscriptionId}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.shoply.gg/v1/stores/{storeId}/subscriptions/{subscriptionId}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.shoply.gg/v1/stores/{storeId}/subscriptions/{subscriptionId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"success": true,
"message": null,
"code": null,
"data": {
"id": "d5b2ae58-5363-4806-bcaf-7fc939e2c948",
"email": "grace@example.com",
"customerId": null,
"productId": "f463e265-097a-4235-bc2f-5239b19a9874",
"variantId": "00e1d395-9ba2-4db3-900a-cb5e2811a2a9",
"productName": "Northwind Pro",
"variantName": "1 month",
"quantity": 1,
"price": 9.99,
"currency": "USD",
"every": 1,
"unit": "month",
"status": "active",
"periodEnd": "2026-11-22T16:20:19Z",
"graceEnd": null,
"renewalOrderId": null,
"renewalUrl": null,
"firstOrderId": "bc44febe-0f25-4076-92eb-03a5045a57e7",
"cycles": 1,
"remindedAt": null,
"endedAt": null,
"revoked": false,
"pausedAt": null,
"resumeAt": null,
"pausedBy": null,
"renewsWith": null,
"autoRenews": false,
"chargeTried": 0,
"chargeNextAt": null,
"createdAt": "2026-10-22T16:20:19Z"
},
"meta": {
"history": [
{
"kind": "started",
"detail": "Subscribed to Northwind Pro, 1 month, $9.99 a month. Renews on Nov 22, 2026.",
"actor": "buyer",
"orderId": "bc44febe-0f25-4076-92eb-03a5045a57e7",
"at": "2026-10-22T16:20:19Z"
}
],
"orders": [
{
"id": "bc44febe-0f25-4076-92eb-03a5045a57e7",
"status": "completed",
"amount": 9.99,
"currency": "USD",
"renewal": false,
"createdAt": "2026-10-22T16:20:19Z",
"paidAt": "2026-10-22T16:20:19Z"
}
]
}
}{
"success": false,
"message": "<string>",
"code": "<string>",
"data": null,
"errors": {}
}{
"success": false,
"message": "<string>",
"code": "<string>",
"data": null,
"errors": {}
}{
"success": false,
"message": "<string>",
"code": "<string>",
"data": null,
"errors": {}
}{
"success": false,
"message": "<string>",
"code": "<string>",
"data": null,
"errors": {}
}Subscriptions
Get a subscription
The subscription as data, with meta.history (what happened to it, newest first) and meta.orders (its first order and every renewal). An order’s subscriptionId names the subscription it started or renewed.
Needs the subscriptions.read permission (Read Subscriptions).
GET
/
stores
/
{storeId}
/
subscriptions
/
{subscriptionId}
Node.js
import Shoply from "@shoplygg/node";
const shoply = new Shoply({ apiKey: process.env.SHOPLY_API_KEY });
const result = await shoply.subscriptions.show("SUBSCRIPTION_ID");<?php
require 'vendor/autoload.php';
$shoply = new Shoply\Client(['apiKey' => getenv('SHOPLY_API_KEY')]);
$result = $shoply->subscriptions->show('SUBSCRIPTION_ID');
import shoply
client = shoply.Client() # reads SHOPLY_API_KEY
result = client.subscriptions.show("SUBSCRIPTION_ID")
curl --request GET \
--url https://api.shoply.gg/v1/stores/{storeId}/subscriptions/{subscriptionId} \
--header 'Authorization: Bearer <token>'package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.shoply.gg/v1/stores/{storeId}/subscriptions/{subscriptionId}"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.shoply.gg/v1/stores/{storeId}/subscriptions/{subscriptionId}")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.shoply.gg/v1/stores/{storeId}/subscriptions/{subscriptionId}")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_body{
"success": true,
"message": null,
"code": null,
"data": {
"id": "d5b2ae58-5363-4806-bcaf-7fc939e2c948",
"email": "grace@example.com",
"customerId": null,
"productId": "f463e265-097a-4235-bc2f-5239b19a9874",
"variantId": "00e1d395-9ba2-4db3-900a-cb5e2811a2a9",
"productName": "Northwind Pro",
"variantName": "1 month",
"quantity": 1,
"price": 9.99,
"currency": "USD",
"every": 1,
"unit": "month",
"status": "active",
"periodEnd": "2026-11-22T16:20:19Z",
"graceEnd": null,
"renewalOrderId": null,
"renewalUrl": null,
"firstOrderId": "bc44febe-0f25-4076-92eb-03a5045a57e7",
"cycles": 1,
"remindedAt": null,
"endedAt": null,
"revoked": false,
"pausedAt": null,
"resumeAt": null,
"pausedBy": null,
"renewsWith": null,
"autoRenews": false,
"chargeTried": 0,
"chargeNextAt": null,
"createdAt": "2026-10-22T16:20:19Z"
},
"meta": {
"history": [
{
"kind": "started",
"detail": "Subscribed to Northwind Pro, 1 month, $9.99 a month. Renews on Nov 22, 2026.",
"actor": "buyer",
"orderId": "bc44febe-0f25-4076-92eb-03a5045a57e7",
"at": "2026-10-22T16:20:19Z"
}
],
"orders": [
{
"id": "bc44febe-0f25-4076-92eb-03a5045a57e7",
"status": "completed",
"amount": 9.99,
"currency": "USD",
"renewal": false,
"createdAt": "2026-10-22T16:20:19Z",
"paidAt": "2026-10-22T16:20:19Z"
}
]
}
}{
"success": false,
"message": "<string>",
"code": "<string>",
"data": null,
"errors": {}
}{
"success": false,
"message": "<string>",
"code": "<string>",
"data": null,
"errors": {}
}{
"success": false,
"message": "<string>",
"code": "<string>",
"data": null,
"errors": {}
}{
"success": false,
"message": "<string>",
"code": "<string>",
"data": null,
"errors": {}
}Authorizations
A secret API key, made under Developers in the dashboard: Authorization: Bearer shoply_sk_...
Path Parameters
The store's ID. A key reaches the store it was made in: GET /key answers which.
The subscription.

