Skip to main content
Use this endpoint to retrieve all created add-ons.

Request

Response

Parameters

from optional : integer The Unix timestamp from when add-ons are to be fetched. to optional : integer The Unix timestamp till when add-ons are to be fetched. count optional : integer The number of add-ons to be fetched. Default value is 10. Maximum value is 100. This can be used for pagination, in combination with skip. skip optional : integer The number of add-ons to be skipped. Default value is 0. This can be used for pagination, in combination with count.

Parameters

id : string The unique identifier of the created add-on. For example, ao_00000000000001. quantity : integer This specifies the number of units of the add-on to be charged to the customer. For example, 2. The total amount is calculated as amount * quantity. created_at : integer The timestamp, in Unix format, when the add-on was created. For example, 1581597318. subscription_id : string The unique identifier of the subscription to which the add-on is being added. For example, sub_00000000000001. invoice_id : string The add-on is added to the next invoice that is generated after the add-on is created. This field is populated only after the invoice is generated. Until then, it is null. Once the add-on is linked to an invoice, it cannot be deleted.

Errors

The API key/secret provided is invalid.
  • code: 4xx
  • description: This error occurs due to a mismatch between the API credentials passed in the API call and those generated on the Dashboard.
  • solution: Ensure that the API keys are active and correctly entered, with no whitespaces before or after the keys.