Developers
API reference

Unlinked Institutions

get/v1/unlinked-institutions

List banks the transactions name but the ledger lacks

unlinked_institutions.listread tokenidempotent

Banks recent transfers keep naming that no account in this ledger is held at: why spending can look too high (a card payment to an unconnected bank has nowhere to go but spending). A short list, the banks the most money moves to first. Banks dismissed in the app are left out.

Parameters

limit
integer · query
Page size, 1–200.
cursor
string | null · query
The next_cursor of the previous page.
X-Organization-Id
string | null · header

Returns 200 · UnlinkedInstitutionList

data
array of UnlinkedInstitution · required
has_more
boolean · required
next_cursor
string | null · required
Example
curl -X GET "https://api.lumaledger.app/v1/unlinked-institutions" \
  -H "Authorization: Bearer $LUMALEDGER_TOKEN"

Objects

Money

An amount and its currency. `amount` is a base-10 string with two decimal places and an optional leading minus sign. Parse it with a decimal type, not a float.

Fields

amount
string · required
Pattern: ^-?\d+\.\d{2}$.
currency
string · required
ISO 4217 code. Pattern: ^[A-Z]{3}$.

UnlinkedInstitution

A bank recent transfers keep going to, with no account in the ledger.

Fields

account_hints
array of string · required
Masked account numbers seen in the descriptions (4821).
counterparty_type
string | null · required
What the bank feed called the other party (financial_institution, payment_app), or null when inferred from a transfer marked by hand.
first_date
date · required
last_date
date · required
name
string · required
The bank as the transactions spell it.
sample_descriptions
array of string · required
slug
string · required
Stable key of the bank's name; what a new institution for it would be keyed on.
total
Money · required
What those transactions add up to, in the currency most of them are in.
transaction_count
integer · required
How many recent transactions name it, in any currency.

UnlinkedInstitutionList

A page of unlinked banks, the ones most money moves to first.

Fields

data
array of UnlinkedInstitution · required
has_more
boolean · required
next_cursor
string | null · required