> ## Documentation Index
> Fetch the complete documentation index at: https://docs.redbark.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Connections

> Retrieve all bank connections for the authenticated user

<Info>
  The REST API is in **beta**. This endpoint's response shape may change.
</Info>

Returns all active connections for the authenticated user. A connection is a linked bank from a specific provider.

## Request

```
GET /v1/connections
```

### Headers

| Header          | Required | Description           |
| --------------- | -------- | --------------------- |
| `Authorization` | Yes      | `Bearer YOUR_API_KEY` |

This endpoint takes no query parameters. All connections are returned in a single response.

## Response

Ordered by `createdAt` descending (most recent first).

```json theme={null}
{
  "data": [
    {
      "id": "b7c4a1e2-8d3f-4e9a-9c5b-1f2a3e4d5c6b",
      "provider": "fiskil",
      "category": "banking",
      "institutionId": "77",
      "institutionName": "Westpac",
      "institutionLogo": "https://cdn.redbark.com/logos/westpac.png",
      "status": "active",
      "lastRefreshedAt": "2026-03-13T02:30:00.000Z",
      "createdAt": "2026-01-15T10:00:00.000Z"
    },
    {
      "id": "d9e2f3a4-5b6c-7d8e-9f01-2345abcdef67",
      "provider": "fiskil",
      "category": "banking",
      "institutionId": "21",
      "institutionName": "Commonwealth Bank",
      "institutionLogo": "https://cdn.redbark.com/logos/commbank.png",
      "status": "active",
      "lastRefreshedAt": "2026-03-12T18:00:00.000Z",
      "createdAt": "2026-02-20T14:30:00.000Z"
    }
  ]
}
```

### Connection object

| Field             | Type             | Description                                                                                                                                                                   |
| ----------------- | ---------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `id`              | `string`         | UUID of the connection                                                                                                                                                        |
| `provider`        | `string`         | `"fiskil"` (AU banking), `"akahu"` (NZ banking), or `"snaptrade"` (brokerage)                                                                                                 |
| `category`        | `string`         | `"banking"` or `"brokerage"`                                                                                                                                                  |
| `institutionId`   | `string`         | Opaque provider-specific institution identifier. Numeric string for Fiskil (e.g. `"77"`), UUID for SnapTrade. Treat as an arbitrary string.                                   |
| `institutionName` | `string`         | Institution display name (e.g. "Westpac", "Interactive Brokers")                                                                                                              |
| `institutionLogo` | `string \| null` | URL to the institution logo, or `null` if unavailable                                                                                                                         |
| `status`          | `string`         | One of `"active"`, `"invalidated"` (consent or credentials expired — user needs to reconnect), `"pending_mfa"` (awaiting a second factor), or `"revoked"` (consent withdrawn) |
| `lastRefreshedAt` | `string \| null` | ISO 8601 timestamp of the last successful data refresh                                                                                                                        |
| `createdAt`       | `string`         | ISO 8601 timestamp of when the connection was created                                                                                                                         |

<Info>
  Connections with status `"deleting"` (mid-teardown) are excluded from the response.
</Info>

## Examples

```bash theme={null}
curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://api.redbark.com/v1/connections
```

```python theme={null}
import requests

resp = requests.get(
    "https://api.redbark.com/v1/connections",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
)
connections = resp.json()["data"]

for conn in connections:
    print(f"{conn['institutionName']} ({conn['provider']}): {conn['status']}")
```

```javascript theme={null}
const resp = await fetch("https://api.redbark.com/v1/connections", {
  headers: { Authorization: "Bearer YOUR_API_KEY" },
});
const { data: connections } = await resp.json();

for (const conn of connections) {
  console.log(`${conn.institutionName} (${conn.provider}): ${conn.status}`);
}
```