Operations API Subscriptions

List subscription add-ons

GET https://api.tamio.com/v2/subscriptions/addons/list/{uuid}

Returns a paginated list of add-ons attached to a subscription.

Path Parameters

uuid string*

UUID of the subscription.

Query Parameters

page integer*

Page number.

per_page integer*

Add-ons per page.

Responses

200 Paginated list of add-ons

Paginated list of add-ons

status integer

total_results integer

Total number of add-ons for this subscription.

addons array of Addon

id string

Unique identifier of the add-on.

object string

Object type identifier.

description string

Add-on name/description.

amount integer

Price in smallest currency unit (e.g. cents).

currency string

ISO currency code (lowercase).

duration string

Billing duration type. once for one-time, limited for fixed number of payments, recurring for ongoing.

oncelimitedrecurring

type string

Add-on type identifier.

subscription_id string

UUID of the parent subscription.

payment_count integer

Number of payments processed for this add-on.

number_of_payments integer

Total payments expected. Only set for limited duration add-ons, null otherwise.

400 Validation or business-logic error.

Code	Description
`1002`	Subscription not found

401 Missing or invalid API key

Remove a discount

Create an add-on

/subscriptions/addons/list/{uuid}

1 const response = await fetch("https://api.tamio.com/v2/subscriptions/addons/list/{uuid}", {
2   headers: {
3     "Authorization": "Bearer YOUR_API_KEY",
4     "Accept": "application/json"
5   }
6 });
7 const data = await response.json();

1 require "uri"
2 require "net/http"
3 
4 url = URI("https://api.tamio.com/v2/subscriptions/addons/list/{uuid}")
5 
6 https = Net::HTTP.new(url.host, url.port)
7 https.use_ssl = true
8 
9 request = Net::HTTP::Get.new(url)
10 request["Accept"] = "application/json"
11 request["Authorization"] = "Bearer YOUR_API_KEY"
12 
13 response = https.request(request)
14 puts response.read_body

Responses

{
  "status": 200,
  "total_results": 3,
  "addons": [
    {
      "id": "fff64567-e89b-12d3-a456-426614174000",
      "object": "addon",
      "description": "Premium Support Package",
      "amount": 1500,
      "currency": "eur",
      "duration": "recurring",
      "type": "subscription_addon",
      "subscription_id": "999e4567-e89b-12d3-a456-426614174000",
      "payment_count": 3,
      "number_of_payments": null
    }
  ]
}

1	const response = await fetch("https://api.tamio.com/v2/subscriptions/addons/list/{uuid}", {
2	headers: {
3	"Authorization": "Bearer YOUR_API_KEY",
4	"Accept": "application/json"
5	}
6	});
7	const data = await response.json();

1	require "uri"
2	require "net/http"
3
4	url = URI("https://api.tamio.com/v2/subscriptions/addons/list/{uuid}")
5
6	https = Net::HTTP.new(url.host, url.port)
7	https.use_ssl = true
8
9	request = Net::HTTP::Get.new(url)
10	request["Accept"] = "application/json"
11	request["Authorization"] = "Bearer YOUR_API_KEY"
12
13	response = https.request(request)
14	puts response.read_body