---
title: "List Bank Connections"
method: GET
path: "/bank-connections"
tags: ["Bank Connections"]
---

# List Bank Connections

`GET /bank-connections`

## Request

- Base URL: `https://api.finta.io/v1`
- URL: `https://api.finta.io/v1/bank-connections`
- Auth: HTTP bearer

Returns all bank connections for the authenticated user, including connections from all supported providers (Plaid, GoCardless, Stripe, Mercury).

## Response `200`

List of bank connections

- BankConnectionsListResponse
  - `bank_connections` BankConnection[], required: List of bank connections
    - `id` string, uuid, required: Unique identifier for the bank connection
    - `name` string, required: Display name of the bank connection (institution name)
    - `provider` 'Plaid' | 'GoCardless' | 'Stripe' | 'Mercury', required: The data provider for this connection
    - `error` string, nullable, required: Error code if the connection requires attention (e.g., ITEM_LOGIN_REQUIRED for Plaid)
  - `meta` object, required
    - `count` integer, required: Number of connections in this response
    - `totalCount` integer, required: Total number of connections available
    - `hasMore` boolean, required: Whether more results are available (always false, no pagination)

## Other responses

- `401`: Unauthorized - missing, invalid, disabled or expired API key
- `403`: API access requires active pro subscription or trial
- `429`: Rate limit exceeded - retry after the `retryAfter` timestamp
- `500`: Internal server error. Failures during authentication return MiddlewareErrorResponse; failures inside the endpoint return ErrorResponse.

---

[API](https://skmtc.dev/finta/apis/finta-api.md) · [All operations](https://skmtc.dev/finta/apis/finta-api/llms.txt) · [OpenAPI document](https://skmtc.dev/finta/apis/finta-api/revisions/80b98582afde?raw)