Get All Subscriptions by User from Cache

This endpoint retrieves all digital wallet token subscriptions belonging to the authenticated user directly from the cache layer. Each subscription record includes the associated payment card details, financial account information, and token status. Use this endpoint when you need a fast read of subscription data without querying the primary data store.

Endpoint

POST /subscriptions/list/cache

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 to display a user's active and historical digital wallet token subscriptions, for example when rendering a card management dashboard or auditing which payment cards have been provisioned to digital wallets. Because results are served from cache, this endpoint offers lower latency than a live database query and is suitable for high-frequency read scenarios. It is appropriate when near-real-time data is acceptable and you do not need the absolute latest state.

Request Body

This endpoint does not require a request body.

Response

200 OK

Returns an array of carddigitalwallettokenresponse objects.

carddigitalwallettokenresponse Object

paymentCard Nested Object

[
  {
    "id": "sub_8a3f21bc4d7e9c01",
    "status": "ACTIVE",
    "createdAt": "2025-11-14T10:23:45Z",
    "updatedAt": "2026-01-07T08:15:00Z",
    "requesterName": "Apple Pay",
    "financialAccount": "fa_c72a9381de540b6f",
    "financialName": "Business Checking",
    "financialNumber": "XXXXXXXXXX",
    "iconUrl": "https://cdn.netevia.com/icons/apple-pay.png",
    "paymentCard": {
      "id": "card_91d4f825bc3ea706",
      "expirationDate": "09/28",
      "last4": "4521",
      "cardholder": "Jane Smith",
      "authorizedUser": null,
      "departament": "Marketing",
      "cardName": "Marketing Card",
      "partnerName": "Netevia Business",
      "formFactor": "Virtual",
      "status": "OPEN"
    }
  },
  {
    "id": "sub_2d6b07e8a1f43c59",
    "status": "SUSPENDED",
    "createdAt": "2025-09-03T14:55:12Z",
    "updatedAt": "2025-12-20T11:40:30Z",
    "requesterName": "Google Pay",
    "financialAccount": "fa_c72a9381de540b6f",
    "financialName": "Business Checking",
    "financialNumber": "XXXXXXXXXX",
    "iconUrl": "https://cdn.netevia.com/icons/google-pay.png",
    "paymentCard": {
      "id": "card_3f8a152cd09b7e24",
      "expirationDate": "03/27",
      "last4": "8874",
      "cardholder": "Jane Smith",
      "authorizedUser": "Tom Reynolds",
      "departament": "Operations",
      "cardName": "Ops Expense Card",
      "partnerName": "Netevia Business",
      "formFactor": "Physical",
      "status": "SUSPENDED"
    }
  }
]

Error Codes

Common Mistakes

• Sending a request body — this endpoint does not accept or require a body; including one will not affect the response but is unnecessary.
• Treating a 404 as an error condition — it simply means the user has no digital wallet token subscriptions yet, not that the endpoint is misconfigured.
• Assuming cached data is always current — the cache may lag slightly behind the live database; for authoritative real-time state, use the non-cached subscriptions endpoint.
• Not handling an empty array response — a 200 OK with [] is a valid response when the user has no subscriptions.

Related Endpoints

• POST /subscriptions/list — Retrieve all subscriptions by user directly from the primary data store (non-cached)
• POST /subscriptions/create — Provision a new digital wallet token subscription for a payment card
• POST /subscriptions/update — Update the status or details of an existing subscription
• POST /cards/list — List all payment cards associated with the authenticated user

Example

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