Fees
Create fee override
https://api.firstleeward.com/v0/feesCreates an account-level override for one fee type. An account has at most one override per fee type; creating a second returns a conflict. Project defaults cannot be created - every project already has one row per fee type.
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
Idempotency-KeystringUnique key for safely retrying this request. Up to 255 characters; we recommend a UUIDv4. The first request executes and its response is cached; subsequent requests with the same key replay the cached response (24h retention).
Body
application/json
typestringrequiredWhich cardholder fee to override.
FX_MARKUPATM_DOMESTIC_VARIABLEATM_DOMESTIC_FIXEDATM_CROSS_BORDER_VARIABLEATM_CROSS_BORDER_FIXEDscopeobjectrequiredThe account the override attaches to.
Show child attributes
typestringrequiredidstring<uuid>requiredThe account to override for.
valueobjectrequiredThe fee value. unit must match the fee type: BPS for a rate-based type, AMOUNT for a fixed one.
Show child attributes
Option 1 · FeeBpsValueInput
unitstringrequiredbpsintegerrequiredRate in basis points of the transaction bill amount (100 bps = 1%).
Option 2 · FeeAmountValueInput
unitstringrequiredamountnumberrequiredFixed fee per transaction, in the project's billing currency.
Response
200A cardholder fee row.
idstring<uuid>requiredFee ID.
typestringrequiredWhich cardholder fee this row sets.
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.
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>requiredversionintegerrequiredIncremented on every change. Transaction events record the version that priced them.
createdAtstringrequiredISO 8601 creation timestamp.
updatedAtstringrequiredISO 8601 last-update timestamp.
400Response for status 400
Option 1 · FeeScopeNotFoundError
errorobjectrequiredShow child attributes
codestringrequiredmessagestringrequireddetailobject | nullrequiredOption 2 · InvalidFeeValueError
errorobjectrequiredShow child attributes
codestringrequiredmessagestringrequireddetailobject | nullrequiredOption 3 · FeeValueUnitMismatchError
errorobjectrequiredShow child attributes
codestringrequiredmessagestringrequireddetailobject | nullrequired409A fee of this type already exists at this scope
errorobjectrequiredShow child attributes
codestringrequiredmessagestringrequireddetailobject | nullrequired