> ## 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.

# SimpleFIN

> Connect Actual Budget, Sure, Firefly III, and other SimpleFIN apps directly to your bank data

Redbark speaks the [SimpleFIN protocol](https://www.simplefin.org/protocol.html), the open standard that self-hosted finance apps use for bank sync. Any app with a SimpleFIN integration, including [Actual Budget](https://actualbudget.org), [Sure](https://github.com/we-promise/sure), and the [Firefly III data importer](https://docs.firefly-iii.org), can pull your accounts, balances, and transactions from Redbark with a single setup token. No API keys, no custom bridge scripts.

<Info>
  SimpleFIN access requires an active **Developer** or **Professional** plan (trials included), the same gate as the REST API. Banking accounts only for now; brokerage accounts are not exposed over SimpleFIN.
</Info>

## How it works

1. In [Settings](https://app.redbark.com/settings), find the **SimpleFIN** section and generate a **setup token**, naming it after the app you are connecting.
2. Paste the setup token into your app's SimpleFIN settings. The app claims it once (within 7 days) and receives its own private access credentials.
3. The app syncs on its own schedule from then on. Revoke the connection any time from the same settings section.

Each connected app gets its own token, so revoking one never breaks another.

## App setup

<Tabs>
  <Tab title="Actual Budget">
    In Actual, open **Settings → Bank Sync**, choose **SimpleFIN**, and paste the setup token when prompted. Then link each Actual account to the matching Redbark account. Requires Actual 24.10.0 or later.
  </Tab>

  <Tab title="Sure">
    In Sure's hosting settings, provide the setup token under the SimpleFIN configuration and follow its account-linking flow.
  </Tab>

  <Tab title="Firefly III">
    Use the Firefly III **data importer** with its SimpleFIN import flow and paste the setup token when the importer asks for one. Set a start date in the importer; without one it walks history from 1970 in 44-day chunks, which makes the first import very slow.
  </Tab>
</Tabs>

## Protocol details

Redbark implements SimpleFIN protocol version 1 at:

```
https://api.redbark.com/simplefin
```

| Endpoint                        | Purpose                                                |
| ------------------------------- | ------------------------------------------------------ |
| `GET /simplefin/info`           | Protocol version probe (`{"versions": ["1.0"]}`)       |
| `POST /simplefin/claim/{token}` | One-time setup-token claim; returns the access URL     |
| `GET /simplefin/accounts`       | Accounts, balances, and transactions (HTTP Basic auth) |

`GET /accounts` supports the standard query parameters: `start-date` and `end-date` (Unix seconds), `pending=1` to include pending transactions, `balances-only=1`, and repeatable `account` filters.

## Limits and behaviour

* Data is proxied live from your bank at request time; Redbark stores none of it.
* Default transaction window is the last 30 days when the app does not send `start-date`; history is capped at \~7 years, matching the underlying providers.
* Up to 2,000 transactions per account per request.
* 300 requests per minute per connected app, sized for client backfills that burst sequentially (Firefly's importer chunks history into 44-day windows). Requests for windows older than the history floor skip the transaction fetch and serve cached balances.
* If one bank connection is unavailable, its accounts report `Connection to <bank> may need attention` in the `errors` array while your other accounts keep syncing.