Subscription resource - Developer documentation

The Subscription object stores information and rules defining the contract between your business and a customer. It is created when a customer purchases a subscription-based product.

Search query fields

Field	Description	Type
id	The subscription identifier	string
serial	The incremental subscription number	string
status	The subscription status	string
createdAt	The date subscription was created	date
updatedAt	The last date the subscription was updated	date
nextBillingDate	The upcoming next billing date	date
canceledAt	The date subscription was cancelled	date
customer	The customer identifier	string

Reference

The schema is of type object.

List customers List subscriptions

{
  "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "resource": "subscription",
  "serial": "<string>",
  "status": "active",
  "createdAt": "2023-11-07T05:31:56Z",
  "updatedAt": "2023-11-07T05:31:56Z",
  "canceledAt": null,
  "customer": "<string>",
  "nextBillingDate": null,
  "currentCycle": 1,
  "items": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "resource": "subscription-item",
      "title": "<string>",
      "subtitle": null,
      "quantity": 2,
      "totalPrice": 1,
      "variant": "<string>",
      "recurringCycleLimit": null
    }
  ],
  "discounts": [
    {
      "id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
      "resource": "subscription-discount",
      "title": null,
      "target": {
        "type": "shipping"
      },
      "value": {
        "amount": 123,
        "type": "fixed-amount",
        "appliesOnEachItem": true
      },
      "recurringCycleLimit": null
    }
  ],
  "paymentMethod": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "currencyCode": "<string>",
  "deliveryAddress": null,
  "deliveryMethod": null,
  "deliveryPrice": 1
}

Core Resources

​Search query fields

​Reference

Search query fields

Reference