LogoLogo
System status
Admin APIs reference
Admin APIs reference
  • Admin APIs reference
  • Order management
    • Refunds
    • Retrieve an order (synchronous API)
    • Retrieve an invoice (synchronous API)
    • Manage orders (synchronous API)
  • Customer management
    • Retrieve a customer (synchronous API)
    • Manage a customer (synchronous API)
  • Subscription mangement
    • Manage a subscription
    • Renew a subscription
    • Apply an immediate midterm change
    • Manage subscription payments
    • Modify the subscription's external reference ID
    • Manage the subscription's address
    • Get all orders
    • Retrieve subscriptions with pending actions
    • Retrieve subscriptions
    • Manage a perpetual price
    • Update a subscription's email address
  • Site management
    • Get authorized countries
  • Product management
    • Manage products (asynchronous API)
    • Retrieve a product (synchronous API)
    • Retrieve the product task status (synchronous API)
  • Offer Management
    • Manage offers (synchronous API)
    • Retrieve an offer (synchronous API)
  • Webhook management
    • Manage webhook events
  • Payment source
    • Source management
  • File management
    • Retrieve a file
Powered by GitBook
On this page
  1. Subscription mangement

Retrieve subscriptions

PreviousRetrieve subscriptions with pending actionsNextManage a perpetual price

Last updated 1 year ago

Get All Subscription By Shopper Id or External Reference Id

get

Get all subscriptions by shopper id or external reference Id

Query parameters
Shopper IdstringRequired

Shopper Id or External Reference Id

Header parameters
tokenstringRequired

Basic authorization (dispatch Key and Secret) or Full access token

Responses
200
OK
application/json
400
* Bad request
application/json
401
* Please verify your API key and secret (if applicable) is correct.
404
* Not found
application/json
409
* Conflict
application/json
get
GET /v1/subscriptions HTTP/1.1
Host: api.digitalriver.com
token: text
Accept: */*
{
  "subscriptions": [
    {
      "freeTrial": true,
      "autoRenewal": true,
      "terms": "Please accept these terms.",
      "planId": "654321",
      "subscriptionId": "665430999",
      "billingAgreementId": "cfeba2ac-d532-49e4-99f4-7a433507facf",
      "startTime": {
        "offset": {
          "totalSeconds": 0,
          "id": "Z",
          "rules": {
            "fixedOffset": true,
            "transitions": [],
            "transitionRules": []
          }
        },
        "nano": 0,
        "year": 2020,
        "monthValue": 5,
        "dayOfMonth": 21,
        "hour": 0,
        "minute": 0,
        "second": 0,
        "month": "MAY",
        "dayOfWeek": "THURSDAY",
        "dayOfYear": 142
      },
      "endTime": {
        "offset": {
          "totalSeconds": 0,
          "id": "Z",
          "rules": {
            "fixedOffset": true,
            "transitions": [],
            "transitionRules": []
          }
        },
        "nano": 0,
        "year": 2021,
        "monthValue": 5,
        "dayOfMonth": 20,
        "hour": 11,
        "minute": 59,
        "second": 59,
        "month": "MAY",
        "dayOfWeek": "THURSDAY",
        "dayOfYear": 140
      }
    }
  ]
}

Get Subscription By Subscription Id

get

Get subscription details by subscription Id

Path parameters
subIdstringRequired

Subscription Id

Header parameters
tokenstringRequired

Basic authorization (dispatch Key and Secret) or Full access token

Responses
200
OK
application/json
400
* Bad request
application/json
401
* Please verify your API key and secret (if applicable) is correct.
404
* Not found
application/json
409
* Conflict
application/json
get
GET /v1/subscriptions/{subId} HTTP/1.1
Host: api.digitalriver.com
token: text
Accept: */*
{
  "freeTrial": true,
  "autoRenewal": true,
  "terms": "Please accept these terms.",
  "planId": "654321",
  "subscriptionId": "665430999",
  "billingAgreementId": "cfeba2ac-d532-49e4-99f4-7a433507facf",
  "startTime": {
    "offset": {
      "totalSeconds": 0,
      "id": "Z",
      "rules": {
        "fixedOffset": true,
        "transitions": [],
        "transitionRules": []
      }
    },
    "nano": 0,
    "year": 2020,
    "monthValue": 5,
    "dayOfMonth": 21,
    "hour": 0,
    "minute": 0,
    "second": 0,
    "month": "MAY",
    "dayOfWeek": "THURSDAY",
    "dayOfYear": 142
  },
  "endTime": {
    "offset": {
      "totalSeconds": 0,
      "id": "Z",
      "rules": {
        "fixedOffset": true,
        "transitions": [],
        "transitionRules": []
      }
    },
    "nano": 0,
    "year": 2021,
    "monthValue": 5,
    "dayOfMonth": 20,
    "hour": 11,
    "minute": 59,
    "second": 59,
    "month": "MAY",
    "dayOfWeek": "THURSDAY",
    "dayOfYear": 140
  }
}
  • GETGet All Subscription By Shopper Id or External Reference Id
  • GETGet Subscription By Subscription Id