Get Plaid-Connected Applications

The GET /api/plaidApplications endpoint retrieves all third-party applications currently connected to the authenticated user's financial accounts through Plaid. Each record includes the application's identity, access metadata, and the specific accounts it is linked to. This endpoint helps users and partners maintain transparency and oversight over external application access to financial data.

Endpoint

GET /api/plaidApplications

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 customer's active Plaid-connected third-party applications, for example in a connected-apps settings screen. It is also useful for auditing which external services have access to a user's financial accounts and for presenting the user with options to review or revoke those connections.

Response

200 OK

Returns an array of plaidclientapplication objects. Each object describes one third-party application and the financial accounts it has access to.

plaidclientapplication object

plaidclientaccount object (nested in accounts)

[
  {
    "applicationId": "app_abc123def456",
    "applicationUrl": "https://www.examplefinanceapp.com",
    "createdAt": "2025-03-15T10:22:00Z",
    "displayName": "Example Finance App",
    "logoUrl": "https://www.examplefinanceapp.com/logo.png",
    "name": "ExampleFinanceApp",
    "reasonForAccess": "Personal finance management and budgeting",
    "accounts": [
      {
        "id": "acct_001",
        "name": "Primary Checking",
        "last4": "7890"
      },
      {
        "id": "acct_002",
        "name": "Savings Account",
        "last4": "1234"
      }
    ]
  },
  {
    "applicationId": "app_xyz789ghi012",
    "applicationUrl": "https://www.paymentplatform.io",
    "createdAt": "2025-05-01T08:00:00Z",
    "displayName": "Payment Platform",
    "logoUrl": "https://www.paymentplatform.io/logo.png",
    "name": "PaymentPlatform",
    "reasonForAccess": "Bill payment and recurring transfers",
    "accounts": [
      {
        "id": "acct_001",
        "name": "Primary Checking",
        "last4": "7890"
      }
    ]
  }
]

Error Codes

Common Mistakes

• Calling this endpoint with a token belonging to a user who has never initiated a Plaid connection will return an empty array, not a 404 error.
• The last4 field in each account object contains only the last four digits of the account number — do not treat it as a full account identifier.
• createdAt reflects when the Plaid connection was established, not when the application itself was created or last active.
• All nullable fields (applicationId, applicationUrl, displayName, logoUrl, name, reasonForAccess, accounts, id, name, last4) may be null if the data is not available from Plaid.

Related Endpoints

• DELETE /api/plaidApplications/{applicationId} — Revoke a specific third-party application's access to the user's financial accounts
• POST /api/plaid/linkToken — Generate a Plaid Link token to initiate a new external account connection
• GET /api/plaidAccounts — List financial accounts connected via Plaid

Example

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