---
title: "GET /v1/subscription/{handle}/available_add_ons"
method: GET
path: "/v1/subscription/{handle}/available_add_ons"
tags: ["subscription"]
---

# GET /v1/subscription/{handle}/available_add_ons

`GET /v1/subscription/{handle}/available_add_ons`

## Request

- Base URL: `https://customer-portal-api.frisbii.com`
- URL: `https://customer-portal-api.frisbii.com/v1/subscription/{handle}/available_add_ons`
- Auth: none declared

Get available add-ons for subscription

## Path parameters

- `handle` string, required

## Response `200`

Successful operation

- AvailableAddOnList
  - `size` integer, required: Page size used in paginated list
  - `count` integer, required: Number of elements in current page. If less than page size it is the last page.
  - `to` string, required: Local date and time range used as to (exclusive)
  - `from` string, required: Local date and time range used as from (inclusive)
  - `content` AvailableAddOn[]: List of available add-ons
    - `handle` string: Per account unique handle for add-on
    - `name` string: Add-on name
    - `description` string: Add-on description
    - `amount` integer: Add-on amount in minor currency unit
    - `vat` number, float: VAT rate
    - `state` string: State of the add-on
    - `currency` string: Currency for the add-on in ISO 4217 three letter alpha code
    - `type` string: Add-on type
    - `created` string, date-time: Date when the add-on was created
    - `deleted` string, date-time: Date when the add-on was deleted if deleted
    - `amount_incl_vat` boolean: Whether the amount is including VAT
    - `billing_period` string: Billing period for the add-on
    - `billing_interval_length` integer: Billing interval length
  - `next_page_token` string: Pagination token to use to get the next page. Notice that page size and range should be the same for all page requests. If not present the last page has been reached.

## Other responses

- `400`: Invalid request, see error codes at https://api.frisbii.com/v1/error_codes
- `401`: None or invalid credentials provided in access to secured resource
- `403`: Not authorized to perform resource operation
- `404`: Resource or referenced resource not found, see error codes at https://api.frisbii.com/v1/error_codes
- `429`: Request limiting exceeded, request rate or concurrent requests, see error code 122 and 123
- `500`: Internal service error, error is reported automatically to Frisbii

---

[API](https://skmtc.dev/frisbii/apis/frisbii-customer-portal-api.md) - [All operations](https://skmtc.dev/frisbii/apis/frisbii-customer-portal-api/llms.txt) - [OpenAPI document](https://skmtc.dev/frisbii/apis/frisbii-customer-portal-api/revisions/f0261fb63b1b?raw)