Get All Subscriptions by User

This endpoint returns a list of all digital wallet token subscriptions linked to the authenticated user. Each subscription record includes details about the associated financial account and the payment card provisioned to the digital wallet. Use this endpoint to display or audit a user's active and historical digital wallet provisioning records.

Endpoint

POST /subscriptions/list

Authentication

Bearer token required. Obtain via:

POST https://api.banking.netevia.dev/api/auth/v2

Include in header: Authorization: Bearer {token}
Token lifetime: 10 minutes. Refresh via POST /api/auth/refresh.

When to use

Use this endpoint when you need to retrieve all digital wallet token subscriptions for a user, such as when displaying a list of provisioned cards in Apple Pay, Google Pay, or similar wallets. It is also useful for auditing which payment cards have been added to digital wallets and checking their provisioning status. Call this endpoint before initiating a new wallet provisioning to check for duplicates or existing subscriptions.

Response

200 OK

Returns an array of carddigitalwallettokenresponse objects.

Top-level subscription fields:

paymentCard nested object fields:

[
  {
    "id": "sub_9f3a12bc-4d7e-4a1c-bd25-8e0f6c3a1d47",
    "status": "ACTIVE",
    "createdAt": "2025-11-15T10:22:34Z",
    "updatedAt": "2026-01-08T14:05:11Z",
    "requesterName": "Google Pay",
    "financialAccount": "fa_7c2e58ad-1b3f-4e9d-a021-dc5f7b6e8c90",
    "financialName": "Business Checking",
    "financialNumber": "XXXXXXXXXX",
    "iconUrl": "https://cdn.netevia.com/icons/google-pay.png",
    "paymentCard": {
      "id": "card_4a8d23ef-7b1c-4f5e-9a03-bc2d6f8e1047",
      "expirationDate": "09/2028",
      "last4": "4321",
      "cardholder": "Jane Doe",
      "authorizedUser": null,
      "departament": "Operations",
      "cardName": "Operations Card",
      "partnerName": "Netevia",
      "formFactor": "Virtual",
      "status": "ACTIVE"
    }
  },
  {
    "id": "sub_1b4c67de-9f2a-4c8b-ae36-7d1e5f9b2c53",
    "status": "SUSPENDED",
    "createdAt": "2025-09-03T08:45:00Z",
    "updatedAt": "2025-12-20T16:30:45Z",
    "requesterName": "Apple Pay",
    "financialAccount": "fa_7c2e58ad-1b3f-4e9d-a021-dc5f7b6e8c90",
    "financialName": "Business Checking",
    "financialNumber": "XXXXXXXXXX",
    "iconUrl": "https://cdn.netevia.com/icons/apple-pay.png",
    "paymentCard": {
      "id": "card_2f6a91bc-3d4e-4b7f-8c12-da9e0f5c3b81",
      "expirationDate": "03/2027",
      "last4": "8876",
      "cardholder": "Jane Doe",
      "authorizedUser": null,
      "departament": null,
      "cardName": "Travel Card",
      "partnerName": "Netevia",
      "formFactor": "Physical",
      "status": "ACTIVE"
    }
  }
]

Error Codes

Common Mistakes

• Sending a GET request instead of POST — this endpoint uses POST even though no request body is required.
• Not including the Authorization: Bearer header, which results in a 401 error.
• Assuming a non-empty array means all subscriptions are active — always check the status field on each subscription and on the nested paymentCard object, as they can differ.
• Treating financialNumber as a plain account number — the value is masked for security; use the financialAccount ID for programmatic reference.

Related Endpoints

• POST /subscriptions/create — Provision a payment card to a digital wallet and create a new subscription
• POST /subscriptions/update — Update the status or details of an existing digital wallet token subscription
• GET /payment-cards — Retrieve all payment cards available to the authenticated user
• GET /financial-accounts — Retrieve all financial accounts associated with the authenticated user

Example

curl -X POST https://api.banking.netevia.dev/subscriptions/list \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json"