Fees
List effective fees
https://api.firstleeward.com/v0/fees/effectiveReturns the fee an account is charged for every fee type: its own override where one exists, otherwise the project default. Each entry names the row it comes from.
Authorizations
Authorizationstring · headerrequiredAPI key as Bearer token, e.g. Bearer YOUR_API_KEY
Headers
Leeward-Versionenum<string>requiredAPI version (YYYY-MM-DD). Available option: 2026-09-18
Query Parameters
accountIdstring<uuid>requiredThe account to resolve fees for.
Response
200The fees an account is charged, each with the row that supplies it.
itemsobject[]requiredOne entry per fee type, in the fee type order.
Show child attributes
typestringrequiredWhich cardholder fee this is.
FX_MARKUPATM_DOMESTIC_VARIABLEATM_DOMESTIC_FIXEDATM_CROSS_BORDER_VARIABLEATM_CROSS_BORDER_FIXEDvalueobjectrequiredThe fee value, denominated as unit says.
Show child attributes
Option 1 · FeeBpsValue
unitstringrequiredbpsintegerrequiredRate in basis points of the transaction bill amount (100 bps = 1%).
Option 2 · FeeAmountValue
unitstringrequiredamountnumberrequiredFixed fee per transaction, in the project's billing currency.
currencystringrequiredCurrency of fixed fee amounts - the billing currency of the project's card program.
sourceobjectrequiredThe row that supplies the value: an account override or the project default.
Show child attributes
feeIdstring<uuid>requiredThe fee row in force.
scopeobjectrequiredWhere the fee attaches. PROJECT rows are the default rate card for your program; an ACCOUNT row overrides one fee type for one account.
Show child attributes
Option 1 · Project
typestringrequiredOption 2 · Account
typestringrequiredidstring<uuid>required400The account the fee attaches to does not exist
errorobjectrequiredShow child attributes
codestringrequiredmessagestringrequireddetailobject | nullrequired