First Leeward

Fees

List fees

GEThttps://api.firstleeward.com/v0/fees

Returns a paginated list of your fee rows - project defaults and account overrides - optionally filtered by type or scope.

Authorizations

Authorizationstring · headerrequired

API key as Bearer token, e.g. Bearer YOUR_API_KEY

Headers

Leeward-Versionenum<string>required

API version (YYYY-MM-DD). Available option: 2026-09-18

Query Parameters

limitintegerdefault: 20

Maximum number of items to return (1-100, default: 20)

cursorstring

Opaque cursor for pagination. Pass nextCursor from previous response to get next page.

typestring[]

Filter by fee type (comma-separated).

Available options:FX_MARKUPATM_DOMESTIC_VARIABLEATM_DOMESTIC_FIXEDATM_CROSS_BORDER_VARIABLEATM_CROSS_BORDER_FIXED
scopeTypestring[]

Filter by scope type (comma-separated).

Available options:PROJECTACCOUNT
scopeIdstring<uuid>

Filter by the exact entity the fee attaches to.

Response

200Response for status 200
itemsobject[]required
Show child attributes
idstring<uuid>required

Fee ID.

typestringrequired

Which cardholder fee this row sets.

Available options:FX_MARKUPATM_DOMESTIC_VARIABLEATM_DOMESTIC_FIXEDATM_CROSS_BORDER_VARIABLEATM_CROSS_BORDER_FIXED
valueobjectrequired

The fee value, denominated as unit says.

Show child attributes
Option 1 · FeeBpsValue
unitstringrequired
bpsintegerrequired

Rate in basis points of the transaction bill amount (100 bps = 1%).

Option 2 · FeeAmountValue
unitstringrequired
amountnumberrequired

Fixed fee per transaction, in the project's billing currency.

currencystringrequired

Currency of fixed fee amounts - the billing currency of the project's card program.

scopeobjectrequired

Where 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
typestringrequired
Option 2 · Account
typestringrequired
idstring<uuid>required
versionintegerrequired

Incremented on every change. Transaction events record the version that priced them.

createdAtstringrequired

ISO 8601 creation timestamp.

updatedAtstringrequired

ISO 8601 last-update timestamp.

nextCursorstring | nullrequired

Cursor for next page, or null if no more items