Get subscriptions

Subscription API v1
GET*base*/subscription/subscriptions?customerEmail=*email*
Authentication:API key

Receive a list of all subscriptions for the customer.

Parameters

customerEmail

string
required
 Customer email address.

Request example

1
GET <base>/subscription?customerEmail=example@centra.com HTTP/1.1

Response

200 Content-type: application/json

status

string
required
 ok if success, else no.

subscriptions

array
required

List of all customer subscriptions.

status

string
required
 The status of the subscription.

id

int
required
 The ID of the subscription.

amount

decimal2 (0.00)
required
 The total value of the subscription.

shipping

decimal2 (0.00)
required
 The shipping value of the subscription.

itemCount

int
required
 The total amount of products in the subscription.

currency

string
 The currency that the subscription was registered with, SEK, USD, EUR, etc.

address

object

An address object with the customer information.

firstName lastName

string
 The name of the customer.

address coaddress city state zipcode phoneNumber

string
 The customer’s address information.

country

string
 The country of the customer. ISO-Alpha-2 (SE, US, GB etc)

createdAt

string
 The date in Y-m-d H-i-s format when the subscription was created.

startDate

string
 The date in Y-m-d format when the subscription starts.

nextOrderDate

string
 The date in Y-m-d format when the subscription has next shipping.

interval

int
 The interval between each subscription. Depending on intervaltype it will be months or days.

intervalType

string

The type of interval for the subscription.

  • Month interval is in months.
  • Day interval is in days.

pricelist

string
 Subscription price list id.

packages

array
 List of subscription packages. Contains packages IDs.

customer

string
 Subscription customer id.

Response example

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
{
  "status": "ok",
  "subscriptions": [
    {
      "status": "active",
      "id": 3,
      "amount": "900.00",
      "shipping": "20.00",
      "itemCount": 2,
      "currency": "SEK",
      "createdAt": "2020-05-05 15:00:00",
      "startDate": "2020-05-05",
      "nextOrderDate": "2020-05-06",
      "interval": 14,
      "intervalType": "Day",
      "pricelist": "19",
      "packages": ["1"],
      "address": {
        "firstName": "Kalle",
        "lastName": "Anka",
        "phoneNumber": "+4687203333",
        "address1": "Malarvarvsbacken 8",
        "address2": "c/o Young Skilled AB",
        "zipCode": "11733",
        "city": "Stockholm",
        "state": "",
        "country": "SE"
      },
      "customer": "132"
    },
    {
      "status": "paused",
      "id": 4,
      "amount": "500.00",
      "shipping": "20.00",
      "itemCount": 1,
      "currency": "SEK",
      "createdAt": "2020-04-03 12:00:00",
      "startDate": "2020-04-03",
      "nextOrderDate": "2020-04-04",
      "interval": 14,
      "intervalType": "Day",
      "pricelist": "19",
      "packages": ["1"],
      "address": {
        "firstName": "Kalle",
        "lastName": "Anka",
        "phoneNumber": "+4687203333",
        "address1": "Malarvarvsbacken 8",
        "address2": "c/o Young Skilled AB",
        "zipCode": "11733",
        "city": "Stockholm",
        "state": "",
        "country": "SE"
      },
      "customer": "132"
    }
  ]
}