Skip to main content
The REST API is in beta. This endpoint’s response shape may change.
Returns all active connections for the authenticated user. A connection is a linked bank from a specific provider.

​
Request

GET /v1/connections

​
Headers

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

​
Response

{
  "data": [
    {
      "id": "conn_abc123",
      "provider": "fiskil",
      "category": "banking",
      "institutionId": "inst_westpac",
      "institutionName": "Westpac",
      "institutionLogo": "https://cdn.redbark.co/logos/westpac.png",
      "status": "active",
      "lastRefreshedAt": "2026-03-13T02:30:00.000Z",
      "createdAt": "2026-01-15T10:00:00.000Z"
    },
    {
      "id": "conn_def456",
      "provider": "fiskil",
      "category": "banking",
      "institutionId": "inst_commbank",
      "institutionName": "Commonwealth Bank",
      "institutionLogo": "https://cdn.redbark.co/logos/commbank.png",
      "status": "active",
      "lastRefreshedAt": "2026-03-12T18:00:00.000Z",
      "createdAt": "2026-02-20T14:30:00.000Z"
    }
  ]
}

​
Connection object

FieldTypeDescription
idstringUnique connection identifier
providerstringProvider name (e.g. "fiskil")
categorystringConnection category (e.g. "banking")
institutionIdstringProvider-specific institution identifier
institutionNamestringInstitution display name (e.g. “Westpac”, “Interactive Brokers”)
institutionLogostring | nullURL to the institution logo, or null if unavailable
statusstring"active", "inactive", or "error"
lastRefreshedAtstring | nullISO 8601 timestamp of the last successful data refresh
createdAtstringISO 8601 timestamp of when the connection was created
Connections with status "deleting" are excluded from the response.

​
Examples

curl -H "Authorization: Bearer rbk_live_..." \
  https://api.redbark.co/v1/connections

import requests

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

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

const resp = await fetch("https://api.redbark.co/v1/connections", {
  headers: { Authorization: "Bearer rbk_live_..." },
});
const { data: connections } = await resp.json();

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