List of External Connected Banks

The /api/enums/banks endpoint returns a comprehensive list of all external banks that can be connected through financial data aggregation services such as Finicity or Plaid. Partners use this list to present customers with selectable institutions when setting up external account links. This is a reference endpoint intended to support account-linking workflows for both personal and business customers.

Endpoint

GET /api/enums/banks

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 building an account-linking flow that requires customers to select their external bank institution. It is typically called before initiating a Finicity or Plaid connection to populate a bank selection list. It can also be used to validate or display the name of a previously linked institution.

Query Parameters

Response

200 OK

The response is a JSON array of strings, where each string is the name of a supported external bank.

[
  "Chase",
  "Bank of America",
  "Wells Fargo",
  "Citibank",
  "US Bank",
  "Capital One",
  "TD Bank",
  "PNC Bank"
]

Error Codes

Common Mistakes

• Omitting the Authorization header will result in a 401 error; this endpoint requires a valid Bearer token even though it returns reference data.
• Passing all=true in production may return banks that are temporarily unavailable for connection; always validate connectivity status before presenting a bank to the end user.
• This endpoint returns plain bank names as strings, not objects — do not expect a structured response with IDs or metadata fields.

Related Endpoints

• GET /api/enums/states — Returns a list of valid US state codes used in address fields
• POST /api/auth/v2 — Obtain a Bearer token required to call this endpoint
• POST /api/auth/refresh — Refresh an expiring Bearer token

Example

curl -X GET "https://api.banking.netevia.dev/api/enums/banks?all=false" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Accept: application/json"