v1

latestOpenAPI 3.1.02026-07-24920300.7 KB

List

Returns a list all of customer subscriptions for a merchant, or a list of subscriptions for an individual customer.

get/subscriptions/

Query parameters

liveboolean[]

Subscription status: active (True) or inactive (False)

productstring

Unique product identifier

shipping_addressstring

Address ID

customerstring

Customer ID (only available in API user scope)

createdstring date

Subscription's created date exact match (yyyy-mm-dd)

created_startstring date

Subscription's created date later or equal than parameter (yyyy-mm-dd)

created_endstring

Subscription's created date sooner or equal than parameter (yyyy-mm-dd)

updatedstring date

Subscription's updated date exact match (yyyy-mm-dd). On subscription creation is populated with same value as created field.

updated_startstring date

Subscription's updated datetime later or equal than parameter (yyyy-mm-ddThh:mm:ss)

updated_endstring date

Subscription's updated date time is sooner or equal than parameter (yyyy-mm-ddThh:mm:ss)

Response

200

countinteger

nextstring

previousstring

Example response

{
  "count": 1,
  "next": "https://restapi.ordergroove.com/subscriptions/?page=1",
  "previous": "https://restapi.ordergroove.com/subscriptions/?page=3",
  "results": [
    {
      "public_id": "f9cb2f93e1c845eb9de9eff46ddb3cbf",
      "price": "12.99",
      "frequency_days": 42,
      "reminder_days": 42,
      "start_date": "2017-02-29 12:00:00",
      "cancel_reason_code": "4|",
      "cancel_reason": "4|Overstocked",
      "merchant_order_id": "301617",
      "subscription_type": "Replenish",
      "components": [
        {
          "public_id": "79d2dc76245111eeb185acde48001122",
          "quantity": 1,
          "product": "0070067690"
        }
      ],
      "created": "2017-02-29 12:00:00",
      "updated": "2017-02-29 12:00:00",
      "extra_data": "{\"some\": \"extra\", \"fields\": \"here\"}",
      "live": "True"
    }
  ]
}