Sample - Stripe API
GET/v1/issuing/personalization_designs/{personalization_design}

Retrieve a personalization design

Retrieves a single personalization design by its identifier. Use expand to request selected fields in expanded form. The returned design includes its physical bundle, preferences, metadata, rejection reasons, and current status.

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

2 parameters
personalization_designstringrequired
The unique identifier of the personalization design. Maximum 5000 characters.
expandarray<string>optional
Fields to expand in the response. Each field name may be up to 5000 characters.

2 status codes
200Returns the personalization design object, including its physical bundle, preferences, metadata, rejection reasons, and current status.
card_logostringoptional
The file for the card logo to use with physical bundles that support card logos. Must have a `purpose` value of `issuing_logo`. Image must be in PNG format with dimensions of 1000px by 200px. It must be a binary (black and white) image containing a black logo on a white background. We don't accept grayscale.
carrier_textobjectoptional
Hash containing carrier text, for use with physical bundles that support carrier text.
createdintegerrequired
Time at which the object was created. Measured in seconds since the Unix epoch.
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`.
lookup_keystringoptional
A lookup key used to retrieve personalization designs dynamically from a static string. This may be up to 200 characters.
metadataobjectrequired
Set of [key-value pairs](https://docs.stripe.com/api/metadata) that you can attach to an object. This can be useful for storing additional information about the object in a structured format.
namestringoptional
Friendly display name.
objectstringrequired
String representing the object's type. Objects of the same type share the same value.
Allowed:issuing.personalization_design
physical_bundlestringrequired
The physical bundle object belonging to this personalization design.
preferencesobjectrequired
rejection_reasonsobjectrequired
statusstringrequired
Whether this personalization design can be used to create cards.
Allowed:activeinactiverejectedreview
defaultReturned when the request cannot be processed; the response contains an `error` object with a reason and error type.
errorobjectrequired

Error handling

personalization_design must identify the design to retrieve and must not exceed 5000 characters. Use expand to request expanded fields, with each field name limited to 5000 characters.