> ## Documentation Index
> Fetch the complete documentation index at: https://sure-917046f5-mintlify-docs-update-1787374966296.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Lunch Flow

> Connect bank accounts worldwide with global coverage

Lunch Flow is a paid third-party provider that offers global bank account connectivity. It's the recommended option for users who need to connect accounts from multiple countries or regions outside the EU and US.

## How it works

Lunch Flow provides a unified API to access bank accounts across different countries and financial institutions:

1. Obtain a Lunch Flow API key
2. Configure the API key in Sure
3. Sure syncs your accounts, balances, and transactions
4. Data is refreshed automatically to keep information current

## Global coverage

Lunch Flow supports financial institutions worldwide, making it ideal for:

* Users with accounts in multiple countries
* Regions not covered by Enable Banking or SimpleFIN
* International banking needs

## Setting up Lunch Flow

To connect your bank accounts:

1. Sign up for a Lunch Flow account at [lunchflow.app](https://lunchflow.app/)
2. Generate an API key from your Lunch Flow dashboard
3. In Sure, add your Lunch Flow API key
4. Sure will automatically discover and sync your connected accounts

## Features

### Account management

* **Account listing**: View all connected accounts with balances
* **Balance tracking**: Real-time balance information in native currencies
* **Transaction history**: Import transactions with date range filtering
* **Investment holdings**: Track investment account holdings and values (where supported)

### Transaction syncing

Sync transactions with flexible filtering:

* Filter by date range (start and end dates)
* Automatic pagination for large transaction sets
* Transaction details include merchant, description, amount, and currency
* **Pending transactions**: Optionally include pending transactions that haven't yet posted to your account

### Investment accounts

For investment accounts, Lunch Flow provides:

* Holdings information (securities, quantities, values)
* Total portfolio value
* Currency-specific valuations

Note: Not all account types support holdings. The API will indicate when holdings are not available for a specific account.

## API structure

Lunch Flow uses a straightforward REST API:

* **GET /accounts**: List all connected accounts
* **GET /accounts/{id}/balance**: Get current balance for an account
* **GET /accounts/{id}/transactions**: Fetch transaction history
* **GET /accounts/{id}/holdings**: Get investment holdings (if supported)

## API reference

For detailed API documentation, see the [Lunch Flow documentation](https://docs.lunchflow.app/introduction).

## Pricing

Lunch Flow is a paid service. Check [lunchflow.app](https://lunchflow.app/) for current pricing information.

## Configuration

### Pending transactions

You can configure Lunch Flow to include pending transactions in your syncs. Pending transactions are those that have been authorized but haven't yet posted to your account.

To enable pending transactions, set the following environment variable:

```bash theme={null}
LUNCHFLOW_INCLUDE_PENDING=1
```

When enabled, transactions marked as pending by Lunch Flow will be imported and displayed with a "Pending" badge in the UI.

### Debug mode

For troubleshooting, you can enable debug logging to see the raw API responses:

```bash theme={null}
LUNCHFLOW_DEBUG_RAW=1
```

## Troubleshooting

### Transactions stuck with a "Pending" badge

When Lunch Flow transitions a transaction from pending to posted, Sure detects the change and refreshes the stored snapshot so the "Pending" badge is cleared on the next sync. If you see a transaction that remains pending after it has posted at your institution, trigger a manual sync from the Accounts page to pick up the updated status.

### Duplicate identical pending transactions

Some institutions return pending transactions without a unique ID. Sure deduplicates these by content hash within a single sync response, so two genuinely identical purchases in the same sync are each preserved as separate entries. Re-syncing the same pair will not create additional duplicates.

## Limitations

* Requires a paid Lunch Flow subscription
* Subject to Lunch Flow API rate limits
* Holdings data not available for all account types
* Coverage varies by country and institution