GET
/v1/issuing/personalization_designsList personalization designs
Lists personalization designs in descending creation order, with the most recently created design first. Filter results by lookup_keys, preferences, or status, and use cursor parameters to navigate between pages. Use limit to control the number of designs returned and expand to request expanded fields.
- RetriesRetries up to 2×, 500ms backoff, 30s timeout.
ending_beforestringoptional
Cursor identifying an object before which to return the previous page. Maximum 5000 characters.
expandarray<string>optional
Fields to expand in the response. Each field name may be up to 5000 characters.
limitintegeroptional
Number of personalization designs to return, from 1 to 100. Defaults to 10 when omitted.
lookup_keysarray<string>optional
Filter designs by lookup keys. Each key may be up to 200 characters.
preferencesobjectoptional
Filter designs by `is_default` or `is_platform_default` preference values.
starting_afterstringoptional
Cursor identifying an object after which to return the next page. Maximum 5000 characters.
statusstringoptional
Filter by design status: active, inactive, rejected, or review.
200Returns a list object containing personalization designs, a `has_more` indicator, the list object type, and the list URL.
dataarray<PersonalizationDesign>required
has_morebooleanrequired
True if this list has another page of items after this one that can be fetched.
objectstringrequired
String representing the object's type. Objects of the same type share the same value. Always has the value `list`.
urlstringrequired
The URL where this list can be accessed.
defaultReturned when the request cannot be processed; the response contains an `error` object with a reason and error type.
errorobjectrequired
Error handling
limit must be between 1 and 100 and defaults to 10 when omitted. status must be one of: active, inactive, rejected, or review; each lookup_keys value must be no longer than 200 characters.