---
title: "List all physical bundles"
method: GET
path: "/v1/issuing/physical_bundles"
---

# List all physical bundles

`GET /v1/issuing/physical_bundles`

## Request

- Base URL: `https://api.stripe.com`
- URL: `https://api.stripe.com/v1/issuing/physical_bundles`
- Auth: one of:
  - HTTP basic
  - HTTP bearer

Returns a list of physical bundle objects. The objects are sorted in descending order by creation date, with the most recently created object appearing first.

## Query parameters

- `ending_before` string
- `expand` string[]
- `limit` integer
- `starting_after` string
- `status` 'active' | 'inactive' | 'review'
- `type` 'custom' | 'standard'

## Response `200`

Successful response.

- object
  - `data` IssuingPhysicalBundle[], required
    - `features` IssuingPhysicalBundleFeatures, required
      - `card_logo` 'optional' | 'required' | 'unsupported', required: The policy for how to use card logo images in a card design with this physical bundle.
      - `carrier_text` 'optional' | 'required' | 'unsupported', required: The policy for how to use carrier letter text in a card design with this physical bundle.
      - `second_line` 'optional' | 'required' | 'unsupported', required: The policy for how to use a second line on a card with this physical bundle.
    - `id` string, required: Unique identifier for the object.
    - `livemode` boolean, required: If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`.
    - `name` string, required: Friendly display name.
    - `object` 'issuing.physical_bundle', required: String representing the object's type. Objects of the same type share the same value.
    - `status` 'active' | 'inactive' | 'review', required: Whether this physical bundle can be used to create cards.
    - `type` 'custom' | 'standard', required: Whether this physical bundle is a standard Stripe offering or custom-made for you.
  - `has_more` boolean, required: True if this list has another page of items after this one that can be fetched.
  - `object` 'list', required: String representing the object's type. Objects of the same type share the same value. Always has the value `list`.
  - `url` string, required: The URL where this list can be accessed.

## Other responses

- `default`: Error response.

## Changes

> 19 revisions in range; 7 not diffed, 2 could not be searched.

- **2026-07-01** `e24a26de4188`: 3 breaking
  - removed the required property `error/payment_intent/latest_charge/anyOf[subschema #2: Charge]/application_fee/anyOf[subschema #2: PlatformFee]/balance_transaction/anyOf[subschema #2: BalanceTransaction]/source/anyOf[subschema #6: Dispute]/payment_method_details/card/network` from the response with the `default` status
  - removed the required property `error/payment_intent/latest_charge/anyOf[subschema #2: Charge]/balance_transaction/anyOf[subschema #2: BalanceTransaction]/source/anyOf[subschema #6: Dispute]/payment_method_details/card/network` from the response with the `default` status
  - removed the required property `error/payment_intent/latest_charge/anyOf[subschema #2: Charge]/failure_balance_transaction/anyOf[subschema #2: BalanceTransaction]/source/anyOf[subschema #6: Dispute]/payment_method_details/card/network` from the response with the `default` status
  - …this revision’s changelog is incomplete

[Operation history](https://skmtc.dev/stainless-api/apis/stripe-api/changes/v1/issuing/physical_bundles/get.md)

---

[API](https://skmtc.dev/stainless-api/apis/stripe-api.md) · [All operations](https://skmtc.dev/stainless-api/apis/stripe-api/llms.txt) · [OpenAPI document](https://skmtc.dev/stainless-api/apis/stripe-api/revisions/7cff4cc46d06?raw)