---
title: "List package options"
method: GET
path: "/package/option/lists"
tags: ["Package"]
---

# List package options

`GET /package/option/lists`

Use this BillingServ API endpoint to list package options. Review the response for the operation result or validation errors.

## Query parameters

- `per_page` integer

## Response `200`

OK

- PackageOptionListResponse
  - `success` true, required
  - `package_options` object, required
    - `data` PackageOption[], required
      - `id` integer, required
      - `user_id` integer
      - `internal_name` string
      - `display_name` string, required
      - `api_type` string, nullable
      - `required` integer, required — 1 when the option must be supplied, otherwise 0.
      - `type` integer, required — Control type: 0 select, 1 text, 2 number, 3 radio, 4 checkbox, 5 switch.
      - `values` PackageOptionValue[], required
        - `id` integer, required
        - `option_id` integer, required
        - `display_name` string, required
        - `cycle_type` integer, required — Billing cycle identifier for this predefined option value.
        - `price` number, double, required
        - `fee` number, double, required
        - `created_at` string, date-time, nullable
        - `updated_at` string, date-time, nullable
        - `deleted_at` string, date-time, nullable
      - `created_at` string, date-time, nullable
      - `updated_at` string, date-time, nullable
      - `deleted_at` string, date-time, nullable

## Other responses

- `401` — Missing or invalid API key
- `403` — Authenticated key does not have permission for this endpoint
- `422` — Validation error

---

[API](https://skmtc.net/b-cdn/apis/billingserv-api-v2.md) · [All operations](https://skmtc.net/b-cdn/apis/billingserv-api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/b-cdn/billingserv-api-v2/revisions/76cfbed5eb40/schema)