v1

latestOpenAPI 3.0.02026-07-26224386470.0 KB

EndUserCalculations

Get EndUser balance

Get balance for given EndUser on a daily and account granularity

get/api/end_users/balance

Query parameters

end_user_idstring nullable

Example:your_end_user_id

end_user_id for statistics; either end_user_id or end_user_heron_id is required

end_user_heron_idstring nullable

Example:eus_VzYMaabWpfbWi4dHKA4sRF

Heron-generated id for end user; either end_user_id or end_user_heron_id is required

to_currency'GBP' | 'USD' | 'EUR' | 'CAD' | 'AUD' | 'null' nullable

Example:USD

ISO 4217 currency code to convert to

timestamp_minstring date-time nullable

Example:2026-07-23T19:53:53.094459

Deprecated (use date_min instead). Filter for transactions with timestamp after the input value

date_minstring date nullable

Example:2026-07-23

Filter for transactions with timestamp after the input value (inclusive). It has precedence over timestamp_min

timestamp_maxstring date-time nullable

Example:2026-07-22T19:53:53.094529

Deprecated (use date_max instead). Filter for transactions with timestamp earlier than the input value

date_maxstring date nullable

Example:2026-07-22

Filter for transactions with date earlier than the input value (inclusive). It has precedence over timestamp_max

include_forecastboolean

If true, forecasts the balances of each account

account_idsstring[]

Filter by specific account reference IDs

[
  "1234",
  "5678"
]

Response

OK. Empty balances include a warning reason when no balance data is available.

warningsstring[]

Empty-balance reason codes. Populated responses return an empty list.

Example response

{
  "daily_balances": [
    {
      "accounts": [
        {
          "account_info": {
            "currency": "USD",
            "heron_id": "dsa_j8ctF2WoDeyc6kXm2j9FDi",
            "institution_name": "Chase",
            "name": "Checking Account",
            "number": "123456789",
            "owner_name": "John Doe",
            "type": "Checking"
          },
          "currency": "USD",
          "currency_converted": "USD",
          "display_account_id": "7505"
        }
      ],
      "accounts_not_converted": [
        {
          "account_info": {
            "currency": "USD",
            "heron_id": "dsa_j8ctF2WoDeyc6kXm2j9FDi",
            "institution_name": "Chase",
            "name": "Checking Account",
            "number": "123456789",
            "owner_name": "John Doe",
            "type": "Checking"
          },
          "currency": "USD",
          "currency_converted": "USD",
          "display_account_id": "7505"
        }
      ],
      "currency": "USD"
    }
  ],
  "forecasted": [
    {
      "balances": [
        {
          "date": "2026-07-23",
          "predicted": 42.42,
          "predicted_lower": 4.24,
          "predicted_upper": 420.42
        }
      ]
    }
  ],
  "summary": {
    "accounts": [
      {
        "account_info": {
          "currency": "USD",
          "heron_id": "dsa_j8ctF2WoDeyc6kXm2j9FDi",
          "institution_name": "Chase",
          "name": "Checking Account",
          "number": "123456789",
          "owner_name": "John Doe",
          "type": "Checking"
        },
        "currency": "USD",
        "currency_converted": "USD",
        "display_account_id": "7505"
      }
    ],
    "accounts_not_converted": [
      {
        "account_info": {
          "currency": "USD",
          "heron_id": "dsa_j8ctF2WoDeyc6kXm2j9FDi",
          "institution_name": "Chase",
          "name": "Checking Account",
          "number": "123456789",
          "owner_name": "John Doe",
          "type": "Checking"
        },
        "currency": "USD",
        "currency_converted": "USD",
        "display_account_id": "7505"
      }
    ],
    "currency": "USD"
  }
}