API / Reference / Card Balance Accounts
Generate a card balance account statement
GET
https://api.light.inc/v1/card-balance-accounts/{accountId}/statement
Generates a statement for a card balance account over a period. Dates are interpreted as UTC day boundaries and all timestamps in the response are in UTC. Runs a fresh provider sync inline so the statement reflects the latest activity.
Authorization
Send one of these on every request. See Authentication for how to get credentials.
- API key
Basic authentication header of the form Basic <api_key>, where <api_key> is your api key.
- Bearer token
Path parameters
-
accountIdstring · uuidrequired
Query parameters
-
fromstring · dateStart of the statement period, inclusive. A UTC calendar date in
YYYY-MM-DDformat. -
tostring · dateEnd of the statement period. A UTC calendar date in
YYYY-MM-DDformat; must be afterfrom.
Response
-
balanceAccountIdstring · uuid -
currencystring -
periodStartstring · date-time -
periodEndstring · date-time -
openingBalanceinteger · int64 -
closingBalanceinteger · int64 -
transactionsarray of object-
providerIdstring -
directionstring⚠️ This enum is not exhaustive; new values may be added in the future.
One of
DEBITCREDIT -
amountinteger · int64 -
runningBalanceinteger · int64 -
bookedAtstring · date-time -
valuedAtstring · date-time -
descriptionstring -
referencestring
-
-
generatedAtstring · date-time