Returns all card subscriptions under the account, ordered by createdAt descending (most recently created first).
The subaccountId, cardId, bankAccountId, state, networkBulkFeedId, companyId, legalEntityId and legalEntityName filters are independent and combine additively — supplying more than one narrows the result set to subscriptions matching all of them.
companyId, legalEntityId and legalEntityName filter on the card's cardholder as it is now: corporate.id, corporate.legalEntity.id and corporate.legalEntity.name (see the Glossary). Each is an exact match; legalEntityName is case-sensitive, and each of legalEntityId and legalEntityName never matches a cardholder whose legal entity lacks that field, so copy it from the cardholder (expand=cardholder shows each cardholder's company and legal entity in the same response). For example, this returns the active subscriptions of one legal entity on one feed:
GET /card-subscriptions?networkBulkFeedId=<feed>&legalEntityId=<id>&state=active
These three filters read cardholder data, so they need the cardholder:read scope, like expand=cardholder. Without it the request returns 403.
Filtering by state accepts any of the states a card subscription reports in its response payload:
pending— enrolled from a network roster while the card is still inactive at the network. The subscription is fully enrolled and billable, but has not yet transacted.active— also returns subscriptions still completing activation, which already report their ownstateasactive.deactivated,expired,reqSCA,failed-to-create— matched exactly.
This endpoint supports offset-based pagination. Pagination links preserve any filters applied to the original request.
Use expand to embed each subscription's card and cardholder in the same response (?expand=card,cardholder) instead of calling GET /cards/{cardId} and GET /cards/{cardId}/cardholder per item. Each embedded resource appears under the item's _embedded with the exact body its own endpoint serves, and requires that endpoint's scope (cards:read for card, cardholder:read for cardholder). Pagination links preserve expand like any other parameter.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
