SubscriptionAddon

Name
object
Type
string
Description
Type of object is always subscriptionAddon.
Allowed values: subscriptionAddon
Name
id
Type
string
Description
Unique identifier for the subscription add-on.
Example: "sad_0SNlurA049MEWV2UNWPbDfW5B40U"
Name
activatedAt
Type
nullable string
Description
Time when the subscription add-on was activated.
Example: "2021-01-15T12:36:57Z"
Name
addon
Type
object
Description
The add-on associated to the subscription add-on.
Name
canceledAt
Type
nullable string
Description
Time when the subscription add-on was canceled.
Example: "2021-01-22T19:39:53Z"
Name
createdAt
Type
string
Description
Time when the subscription add-on was created.
Example: "2021-01-15T12:30:28Z"
Name
currentPeriod
Type
nullable object
Description
Current subscription add-on period. Only present for active subscription add-ons.
Name
number
Type
integer
Description
Sequence number of the period.
Example: 1
>= 1
Name
start
Type
string
Description
Beginning of the period.
Example: "2021-01-21T19:32:13Z"
Name
end
Type
string
Description
End of the period.
Example: "2021-02-20T19:38:34Z"
Name
endedAt
Type
string
Description
Time when the subscription add-on was ended.
Example: "2021-01-30T23:12:28Z"
Name
status
Type
string
Description
The current status of the subscription add-on.
Allowed values: pending initiated active ended
Name
subscription
Type
string
Description
Unique identifier of the subscription the add-on applies to.
Example: "sub_0SNlurA049MEWV2gSfSxi00xlPIi"
Name
user
Type
string
Description
Unique identifier of the user the subscription add-on belongs to.
Example: "usr_0SNlurA049MEWV4OpCwsNyC9Kn2d"

Example

{
  "object": "subscriptionAddon",
  "id": "sad_0SNlurA049MEWV2UNWPbDfW5B40U",
  "activatedAt": "2021-01-15T12:36:57Z",
  "addon": {
    "object": "addon",
    "id": "add_0SNlurA049MEWV4VxLfwJc7PJtHc",
    "activationTrigger": "creation",
    "allowances": {
      "dataBytes": 10000000000,
      "voiceSeconds": 30000,
      "smsMessages": 100
    },
    "createdAt": "2021-01-21T19:12:28.0Z",
    "description": "Disable international roaming.",
    "name": "1GB Data Top-up",
    "plans": [
      "pln_0SNlurA049MEWV3V0q7gjQbM4EVo"
    ],
    "price": {
      "amount": 999,
      "currency": "USD"
    },
    "provider": "p5",
    "recurrenceType": "oneTime",
    "status": "draft",
    "type": "topUp",
    "validity": {
      "unit": "day",
      "value": 7
    },
    "data": 10000000000,
    "dataUnit": "byte",
    "sms": 100,
    "smsUnit": "message",
    "voice": 30000,
    "voiceUnit": "second"
  },
  "canceledAt": "2021-01-22T19:39:53Z",
  "createdAt": "2021-01-15T12:30:28.0Z",
  "currentPeriod": {
    "number": 1,
    "start": "2021-01-21T19:32:13.0Z",
    "end": "2021-02-20T19:38:34.0Z"
  },
  "endedAt": "2021-01-30T23:12:28.0Z",
  "status": "pending",
  "subscription": "sub_0SNlurA049MEWV2gSfSxi00xlPIi",
  "user": "usr_0SNlurA049MEWV4OpCwsNyC9Kn2d"
}