---
title: "Get Unused User Bundles"
method: GET
path: "/bundle_pricing/user_bundles/unused"
tags: ["User Bundles"]
---

# Get Unused User Bundles

`GET /bundle_pricing/user_bundles/unused`

Returns all user bundles that aren't in use.

## Query parameters

- `filter` object
  - `country_iso` string[] — Filter by country code.
  - `resource` string[] — Filter by resource.

## Headers

- `authorization_bearer` string — Authenticates the request with your Telnyx API V2 KEY

## Response `200`

Successful Response

- UnusedUserBundlesResponse
  - `data` UnusedUserBundlesSchema[], required
    - `billing_bundle` BillingBundleSummary, required
      - `id` string, uuid, required — Bundle's ID, this is used to identify the bundle in the API.
      - `name` string, required — Bundle's name, this is used to identify the bundle in the UI.
      - `slug` string — Slugified version of the bundle's name.
      - `cost_code` string, required — Bundle's cost code, this is used to identify the bundle in the billing system.
      - `is_public` boolean, required — Available to all customers or only to specific customers.
      - `created_at` string, date, required — Date the bundle was created.
      - `mrc_price` number, float — Monthly recurring charge price.
      - `currency` string — Bundle's currency code.
      - `specs` string[]
    - `user_bundle_ids` string[], required — List of user bundle IDs for given bundle.

## Other responses

- `400` — Invalid request parameters
- `401` — Authentication required or invalid credentials
- `default` — Unexpected error

---

[API](https://skmtc.net/team-telnyx/apis/telnyx-api.md) · [All operations](https://skmtc.net/team-telnyx/apis/telnyx-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/team-telnyx/telnyx-api/versions/e32d46c5945b/schema)