GALANTHUS / ABI FUNCTION REFERENCE
gln_get_balance_as_of_date
Declared in <galanthus/c_api/gln_capi.h>.
GLN_API const char* GLN_CALL gln_get_balance_as_of_date(const gln_balance_t* in_balance);
Purpose
Returns the balance as-of date when available.
Return
Returns the provider's as-of date for the booked balance when the row supplies one. It describes when the balance value was reported, not a due date. Returns NULL when the optional field is not materialized or when the input handle is NULL.
| Type | Nullability | Ownership |
|---|---|---|
const char* | nullable | borrowed |
Parameters
| Name | Direction | Type | Nullability | Ownership |
|---|---|---|---|---|
in_balance | input | const gln_balance_t* | nullable | borrowed |
Date Semantics
Returns the provider's as-of date for the booked balance when the row supplies one. It describes when the balance value was reported, not a due date.
FinTS 3.x balance parsing normalizes numeric dates to YYYY-MM-DD; CAMT and FinTS 4.1 paths preserve the date text from the source payload.
Notes
Passing NULL for in_balance is allowed and returns NULL.
NULL means the provider did not supply this optional field for the row.
The returned pointer is borrowed from the owning backend result envelope and becomes invalid when that envelope is destroyed.