Get Financial Accounts with Details

This endpoint returns a full list of financial accounts linked to a user profile, including account numbers, routing numbers, available cash balances, account status, and associated card product configurations. It is the primary method for obtaining a complete overview of a customer's financial account portfolio within the Netevia platform.

Endpoint

GET /netevia/financialAccount/details

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 display a full summary of a user's financial accounts in a banking application dashboard. It is suitable for retrieving account numbers, balances, and card profile assignments in a single call. This endpoint is also useful for account management workflows where you need to verify account status or identify which card products are linked to each account.

Query Parameters

Response

200 OK

Returns an array of financial account detail objects.

Financial Account Details Object (financialaccountdetailsmodel)

Card Product Object (cardproductresponse)

Card Profile Set Object (cardprofileset)

Card Profile Set Response Object (cardprofilesetresponse)

Extends cardprofileset with the following additional fields:

Card Design Settings Object (carddesignsettings)

[
  {
    "financialAccountId": "fa-7a3b92e1-4c5d-4f8a-b123-abc456def789",
    "userProfileId": 10245,
    "name": "Primary Checking",
    "accountNumber": "XXXXXXXXXX",
    "routingNumber": "021000021",
    "status": "ACTIVE",
    "availableCash": 524750,
    "created": "2024-03-15T10:22:00Z",
    "cardProfileSets": [
      {
        "id": "cps-001",
        "name": "Standard Visa Debit",
        "intent": "DEBIT",
        "network": "VISA",
        "status": "ACTIVE",
        "cardProductId": "cp-visa-debit-001",
        "displayName": "Netevia Visa Debit",
        "isDefault": true,
        "description": "Standard debit card profile for everyday spending",
        "cardDesign": {
          "frontSideImageUrlXs": "https://assets.netevia.com/cards/visa-debit-front-xs.png",
          "frontSideImageUrlXl": "https://assets.netevia.com/cards/visa-debit-front-xl.png",
          "backSideImageUrlXl": "https://assets.netevia.com/cards/visa-debit-back-xl.png",
          "burnerFrontSideImageUrlXs": "https://assets.netevia.com/cards/burner-front-xs.png",
          "burnerFrontSideImageUrlXl": "https://assets.netevia.com/cards/burner-front-xl.png",
          "burnerBackSideImageUrlXl": "https://assets.netevia.com/cards/burner-back-xl.png"
        }
      }
    ],
    "cardProduct": {
      "name": "Netevia Visa Debit",
      "id": "cp-visa-debit-001",
      "usage": "CONSUMER"
    },
    "isLockBoxAccount": false
  }
]

Error Codes

Common Mistakes

• Passing an invalid or non-integer value for profileId or withStatus will result in a 400 error; ensure these are properly typed integers.
• The availableCash field is returned in cents (smallest currency unit), not dollars — divide by 100 to display a dollar amount to end users.
• Omitting profileId when acting on behalf of a specific customer will return accounts for the authenticated user instead of the intended customer.
• The withStatus parameter accepts only the integer values 0–4 from the status enum; passing string status labels will be rejected.
• Account numbers in the response should be masked when displayed to end users; never expose raw account numbers in a client-facing UI.

Related Endpoints

• GET /netevia/financialAccount — Retrieve a lightweight list of financial accounts without full details
• POST /netevia/financialAccount — Create a new financial account for a customer profile
• GET /netevia/financialAccount/{financialAccountId} — Retrieve details for a single financial account by ID
• GET /netevia/financialAccount/{financialAccountId}/transactions — Retrieve transaction history for a specific financial account

Example

curl -X GET "https://api.banking.netevia.dev/netevia/financialAccount/details?profileId=10245&withPartners=false&withStatus=1" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json"