Sample - Stripe API
GET/v1/issuing/physical_bundles/{physical_bundle}

Retrieve a physical bundle

Retrieves an Issuing physical bundle object by its identifier. Use physical_bundle to select the bundle and expand to request expanded response fields when needed.

  • RetriesRetries up to 2×, 500ms backoff, 30s timeout.

2 parameters
physical_bundlestringrequired
The unique identifier of the physical bundle to retrieve. Must not exceed 5000 characters.
expandarray<string>optional
Specifies response fields to expand; each value can contain up to 5000 characters.

2 status codes
200Returns a physical bundle object containing its identifier, display name, status, type, livemode state, and physical-item features.
featuresobjectrequired
idstringrequired
Unique identifier for the object.
livemodebooleanrequired
If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`.
namestringrequired
Friendly display name.
objectstringrequired
String representing the object's type. Objects of the same type share the same value.
Allowed:issuing.physical_bundle
statusstringrequired
Whether this physical bundle can be used to create cards.
Allowed:activeinactivereview
typestringrequired
Whether this physical bundle is a standard Stripe offering or custom-made for you.
Allowed:customstandard
defaultError response.
errorobjectrequired

Error handling

physical_bundle must identify the physical bundle to retrieve and must not exceed 5000 characters. Each value in expand must be a string of no more than 5000 characters.