GET
/v1/issuing/authorizationsList Issuing authorizations
Lists Issuing authorizations, ordered from newest to oldest by creation date. Use card, cardholder, created, and status to filter the results, and use cursor parameters to navigate between pages. Set limit between 1 and 100; it defaults to 10 when omitted.
- RetriesRetries up to 2×, 500ms backoff, 30s timeout.
cardstringoptional
Return only authorizations belonging to the specified card. Maximum 5,000 characters.
cardholderstringoptional
Return only authorizations belonging to the specified cardholder. Maximum 5,000 characters.
createdobjectoptional
Filter authorizations by creation time using a Unix timestamp or a range with `gt`, `gte`, `lt`, and `lte`.
ending_beforestringoptional
Authorization ID cursor that defines the end of the page when retrieving earlier results. Maximum 5,000 characters.
expandarray<string>optional
Fields to expand in each returned authorization.
limitintegeroptional
Maximum number of authorizations to return. Must be between 1 and 100. Defaults to 10 when omitted.
starting_afterstringoptional
Authorization ID cursor that defines the start of the page when retrieving later results. Maximum 5,000 characters.
statusstringoptional
Return only authorizations with the specified status: `closed`, `expired`, `pending`, or `reversed`.
200Returns a paginated list object containing authorization records, the `has_more` indicator, the list object type, and the collection URL.
dataarray<Authorization>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 API error object with a type and error details.
errorobjectrequired
Error handling
limit must be between 1 and 100 and defaults to 10 when omitted. If supplied, status must be one of closed, expired, pending, or reversed; use starting_after and ending_before as authorization ID cursors for pagination.