Skip to main content
The REST API is in beta. This endpoint’s response shape may change.
Returns a paginated list of all accounts across the authenticated user’s active connections.

​
Request

GET /v1/accounts

​
Headers

HeaderRequiredDescription
AuthorizationYesBearer rbk_live_...

​
Query parameters

ParameterTypeDefaultDescription
limitinteger50Maximum items to return (1 to 200)
offsetinteger0Number of items to skip

​
Response

{
  "data": [
    {
      "id": "acc_abc123",
      "connectionId": "conn_abc123",
      "provider": "fiskil",
      "name": "Everyday Account",
      "type": "transaction",
      "institutionName": "Westpac",
      "accountNumber": "xxxx4567",
      "currency": "AUD"
    },
    {
      "id": "acc_def456",
      "connectionId": "conn_abc123",
      "provider": "fiskil",
      "name": "Savings Account",
      "type": "savings",
      "institutionName": "Westpac",
      "accountNumber": "xxxx8901",
      "currency": "AUD"
    }
  ],
  "pagination": {
    "total": 5,
    "limit": 50,
    "offset": 0,
    "hasMore": false
  }
}

​
Account object

FieldTypeDescription
idstringUnique account identifier
connectionIdstringID of the parent connection
providerstring | nullProvider name (e.g. "fiskil")
namestringAccount name (e.g. “Everyday Account”)
typestringAccount type: "transaction", "savings", "credit_card", etc.
institutionNamestring | nullInstitution name (e.g. “Westpac”)
accountNumberstring | nullMasked account number, last 4 digits only (e.g. "xxxx4567")
currencystringISO 4217 currency code (e.g. "AUD", "USD")
Account numbers are always masked. Only the last 4 digits are returned. Accounts on connections being deleted are excluded.

​
Pagination object

FieldTypeDescription
totalintegerTotal number of accounts
limitintegerLimit applied to this request
offsetintegerOffset applied to this request
hasMorebooleantrue if more items exist beyond this page

​
Examples

​
Basic request

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

​
With pagination

curl -H "Authorization: Bearer rbk_live_..." \
  "https://api.redbark.co/v1/accounts?limit=10&offset=10"

​
Python

import requests

resp = requests.get(
    "https://api.redbark.co/v1/accounts",
    headers={"Authorization": "Bearer rbk_live_..."},
    params={"limit": 100},
)
data = resp.json()

for account in data["data"]:
    print(f"{account['name']} ({account['currency']}): {account['accountNumber']}")

print(f"Showing {len(data['data'])} of {data['pagination']['total']} accounts")

​
JavaScript

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

for (const account of accounts) {
  console.log(`${account.name} (${account.currency}): ${account.accountNumber}`);
}

console.log(`Showing ${accounts.length} of ${pagination.total} accounts`);