Account Statement
Account Statement service description
Request
POST https://connect.lhv.com/account-statement
Account Statement provides a list of incoming and outgoing transactions and payments with additional details. It can be requested for one customer account for the specified period.
Both Account Statement and Account Balance requests share the same ISO 20022 Account Report Request camt.060.001.03 XML format.
Depending on the service, different values in the request can be used to get data for different periods or details. Some of these values affect only statement or balance responses.
Headers
Content-Type
application/xml
Client-Code
customer value
Client-Country
customer value
Body
XML structure description:
Message root
[1..1]
MessageRoot
<AcctRptgReq>
Group header and Reporting Request
[1..1]
+GroupHeader
<GrpHdr>
[1..1]
++MessageIdentification
<MsgId>
Unique message identifier generated by requesting party.
[1..1]
++CreationDateTime
<CreDtTm>
[1..1]
+ReportingRequest
<RptgReq>
[0..1]
++Identification
<Id>
[1..1]
++RequestedMessageNameIdentification
<ReqdMsgNmId>
Supported values:
'camt.053.001.02' – Used for account statement requests
Endpoint: POST /account-statement
'camt.052.001.06' – Used for account balance requests
Endpoint: POST /account-balance
[0..1]
++Account
<Acct>
[1..1]
+++Identification
<Id>
[1..1]
++++IBAN
<IBAN>
IBAN of the account to which the report request applies.
When using VIBAN or Indirect Scheme Participant account services, the master account IBAN must be provided.
VIBANs or Indirect Scheme Participant accounts are displayed only in the account statement report and are not accepted in the request.
[1..1]
++AccountOwner
<AcctOwnr>
[1..1]
+++Party
<Pty>
Values are ignored.
[0..1]
++ReportingPeriod
<RptgPrd>
Mandatory for account statement requests.
[1..1]
+++FromToDate
<FrToDt>
Date filters apply only to statement requests; balance requests always return real-time data.
[1..1]
++++FromDate
<FrDt>
Statement request:
Account statement FromDate in ISO 8601 date format (YYYY-MM-DD).
Must not be later than ToDate.
Used together with ToDate to define the requested reporting period.
Balance request:
Value is ignored. Balance responses always return real-time balances, independent of the provided date.
[0..1]
++++ToDate
<ToDt>
Statement request:
Mandatory element.
Account statement ToDate in ISO 8601 date format (YYYY-MM-DD).
Must not be earlier than FromDate.
If a future date is provided, the system uses the current day as the effective end date.
Balance request:
Value is ignored. Balance responses always return real-time balances, independent of the provided date.
[1..1]
+++FromToTime
<FrToTm>
Time filters apply only to statement requests; balance requests always return real-time data.
Values are ignored if Requested Balance Type (ReqdBalTp) block is not added or if ReqdBalTp.CdOrPrtry.Cd.Prtry = 'DATE'.
Values are used when ReqdBalTp.CdOrPrtry.Cd.Prtry = 'DATETIME'
[1..1]
+++FromTime
<FrTm>
Statement request:
Account statement FromTime in ISO 8601 time format with UTC offset (e.g. 11:00:00+02:00).
Inclusive.
Used together with ToTime when the reporting period type is set to 'DATETIME'.
Balance request:
Value is ignored. Balance responses always return real-time balances, independent of the provided time range.
[0..1]
+++ToTime
<ToTm>
Statement request:
Account statement ToTime in ISO 8601 time format with UTC offset (e.g. 11:00:00+02:00).
Exclusive.
Used together with FromTime when the reporting period type is set to 'DATETIME'.
Balance request:
Value is ignored. Balance responses always return real-time balances, independent of the provided time range.
[1..1]
+++Type
<Tp>
‘ALLL’
[0..1]
++Requested Balance Type
<ReqdBalTp>
Provides details on the requested balance reporting.
[1..1]
+++Code or Proprietary
<CdOrPrtry>
[1..1]
++++Code
<Cd>
Not used
[1..1]
++++Proprietary
<Prtry>
Statement request:
'DATE' – Statement is generated based on FromDate and ToDate only. FromTime and ToTime are ignored.
'DATETIME' – Statement is generated using FromDate / ToDate together with FromTime and ToTime.
Balance request:
PAYMENT_LIMITS – Balance response additionally includes payment limits information.
Example
Account statement request for a full day.
Prtry=DATE is used to request day-based reporting
Time elements are not evaluated
Account statement request for a specific time range within a day.
Prtry=DATETIME is used to enable time-based filtering
FrTm and ToTm define the requested time range within the specified dates
FrTm is inclusive and ToTm is exclusive
Response
Headers
Content-Type
application/xml
X-Bank-Code
LHVUK, LHVEE
Body
Request accepted — no content.
Error code and description
Response Message
Response message is created and can be requested through the Messages services.
Response message format follows the ISO standard camt.053.001.02.
HTTP Header Message-Response-Type: ACCOUNT_STATEMENT
Body
Message root
[1..1]
MessageRoot
<BkToCstmrStmt>
Group header
[1..1]
+GroupHeader
<GrpHdr>
[1..1]
++MessageIdentification
<MsgId>
Unique message identifier generated by requesting party. Maximum length 35 characters.
[1..1]
++CreationDateTime
<CreDtTm>
Date and time when the account statement message is created at LHV.
[0..1]
++MessageRecipient
<MsgRcpt>
Not used.
[0..1]
++MessagePagination
<MsgPgntn>
For long account statements containing a large number of transactions, pagination can be used. One account statement response can generate more than one response in the queue. This optional block is then used. The current pagination limit is 10k transactions.
[0..1]
+++PageNumber
<PgNb>
Sequence number of current paginated long account statement portion.
[0..1]
+++LastPageIndicator
<LastPgInd>
Indicator if current account statement portion is the last one - true/false.
Statement
[1..n]
+Statement
<Stmt>
[1..1]
++Identification
<Id>
Unique identification provided by LHV. Identification is generated from the value of GrpHdr.MsgId and the currency for which this Statement block is generated.
[0..1]
++ElectronicSequenceNumber
<ElctrncSeqNb>
Not used.
[0..1]
++LegalSequenceNumber
<LglSeqNb>
Not used.
[1..1]
++CreationDateTime
<CreDtTm>
Date and time when the account statement is generated at LHV.
[1..1]
++FromToDate
<FrToDt>
Defines the requested statement period.
For DATETIME requests, both date and time are taken from FrToDt and FrToTm and normalised to the Europe/London timezone (including UTC offset).
For DATE requests, the period covers the full day, from 00:00:00 to 23:59:59 in Europe/London time.
[1..1]
+++FromDateTime
<FrDtTm>
Start date of the reporting period.
[1..1]
+++ToDateTime
<ToDtTm>
End date of the reporting period.
[1..1]
++Account
<Acct>
[1..1]
+++Identification
<Id>
[1..1]
++++IBAN
<IBAN>
IBAN for which this statement block is generated.
[0..1]
+++Currency
<Ccy>
Account currency for which this statement block is generated.
[0..1]
+++Servicer
<Svcr>
Full information about LHV.
[1..1]
++++FinancialInstitutionIdentification
<FinInstnId>
[0..1]
+++++BIC
<BIC>
LHVBGB2L
[0..1]
+++++Name
<Nm>
LHV BANK LIMITED
[0..1]
+++++PostalAddress
<PstlAdr>
LHV Bank address
[0..1]
++RelatedAccount
<RltdAcct>
Not used.
[1..n]
++Balance
<Bal>
[1..1]
+++Type
<Tp>
[1..1]
++++CodeOrProprietary
<CdOrPrtry>
[0..1]
+++CreditLine
<CdtLine>
Not used.
[1..1]
+++Amount
<Amt>
Balance amount.
[1..1]
+++Date
<Dt>
[1..1]
++++Date
<Dt>
Balance date.
[1..1]
++TransactionsSummary
<TxsSummry>
[0..1]
+++TotalEntries
<TtlNtries>
Not used.
[1..1]
+++TotalCreditEntries
<TtlCdtNtries>
[0..1]
++++NumberOfEntries
<NbOfNtries>
Number of credit entries in a given Statement block.
[1..1]
++++Sum
<Sum>
Sum of all credit entries in a given statement block.
[1..1]
+++TotalDebitEntries
<TtlDbtNtries>
[0..1]
++++NumberOfEntries
<NbOfNtries>
Number of debit entries in a given Statement block.
[1..1]
++++Sum
<Sum>
Sum of all debit entries in a given Statement block.
[0..n]
++Entry
<Ntry>
[0..1]
+++EntryReference
<NtryRef>
Not used.
[1..1]
+++Amount
<Amt>
Transaction amount (may be zero).
[0..1]
+++ReversalIndicator
<RvslInd>
When set to True, the corresponding entry is a reversal of a previously booked entry.
[1..1]
+++Status
<Sts>
BOOK
[1..1]
+++BookingDate
<BookgDt>
[1..1]
++++Date
<Dt>
Booking date.
[1..1]
+++ValueDate
<ValDt>
[1..1]
++++DateTime
<DtTm>
Transaction date and time in Europe/London timezone, including UTC offset (e.g. +00:00 or +01:00).
[1..1]
+++AccountServicerReference
<AcctSvcrRef>
Unique payment ID assigned by the bank.
[1..1]
+++BankTransactionCode
<BkTxCd>
[1..1]
++++Domain
<Domn>
[1..1]
+++++Family
<Fmly>
[0..1]
++++Proprietary
<Prtry>
[0..1]
+++AdditionalInformationIndicator
<AddtlInfInd>
Not used.
[1..n]
+++EntryDetails
<NtryDtls>
[0..1]
++++Batch
<Btch>
Not used.
[0..n]
++++TransactionDetails
<TxDtls>
[1..1]
+++++References
<Refs>
[0..1]
++++++MessageIdentification
<MsgId>
Not used.
[0..1]
++++++AccountServicerReference
<AcctSvcrRef>
Unique payment ID assigned by the bank.
[0..1]
++++++PaymentInformationIdentification
<PmtInfId>
Unique identification assigned by a sending party. For outgoing payments, this is a reference to the original Pain.001.001.09 message value PmtInf.PmtInfId.
[0..1]
++++++InstructionIdentification
<InstrId>
Payment order number.
[0..1]
++++++EndToEndIdentification
<EndToEndId>
[0..1]
++++++TransactionIdentification
<TxId>
Not used.
[0..1]
+++++RelatedParties
<RltdPties>
[0..1]
++++++InitiatingParty
<InitgPty>
Not used.
[0..1]
++++++Debtor
<Dbtr>
Included for credit entries and for debit entries on the VIBAN / Indirect Scheme Participant account.
Omitted for other debit entries.
[0..1]
+++++++Name
<Nm>
Debtor’s name.
[0..1]
++++++++Country
<Ctry>
Debtor’s country ISO code.
[0..7]
++++++++AddressLine
<AdrLine>
Debtor’s address.
[0..1]
+++++++Identification
<Id>
If the account statement was requested for a VIBAN / Indirect Scheme Participant master account, this tag is empty for a debit transaction.
[1..1]
{Or
++++++++OrganisationIdentification
<OrgId>
[0..1]
+++++++++BICOrBEI
<BICOrBEI>
Debtor’s BIC or BEI.
[0..n]
+++++++++Other
<Othr>
[1..1]
++++++++++Identification
<Id>
Debtor’s identification.
[1..1]
Or}
++++++++PrivateIdentification
<PrvtId>
[0..1]
+++++++++DateAndPlaceOfBirth
<DtAndPlcOfBirth>
[1..1]
++++++++++BirthDate
<BirthDt>
Debtor’s birth date.
[1..1]
++++++++++CityOfBirth
<CityOfBirth>
Debtor’s city of birth.
[1..1]
++++++++++CountryOfBirth
<CtryOfBirth>
Debtor’s country of birth.
[0..n]
+++++++++Other
<Othr>
[1..1]
++++++++++Identification
<Id>
Debtor’s identification.
[0..1]
++++++++++SchemeName
<SchmeNm>
[0..1]
++++++DebtorAccount
<DbtrAcct>
Included for credit entries and for debit entries on the VIBAN / Indirect Scheme Participant account.
[1..1]
+++++++Identification
<Id>
[1..1]
{Or
++++++++IBAN
<IBAN>
Debtor’s IBAN.
[1..1]
Or}
++++++++Other
<Othr>
[1..1]
+++++++++Identification
<Id>
Debtor’s bank account number that is not an IBAN. For Faster Payments (incoming), this is the UK sort code + account number (14 characters).
[0..1]
++++++UltimateDebtor
<UltmtDbtr>
[0..1]
+++++++Name
<Nm>
Ultimate debtor’s name.
[0..1]
+++++++Identification
<Id>
[1..1]
{Or
++++++++OrganisationIdentification
<OrgId>
[0..1]
+++++++++BICOrBEI
<BICOrBEI>
Ultimate debtor’s BIC or BEI.
[0..n]
+++++++++Other
<Othr>
[1..1]
++++++++++Identification
<Id>
Ultimate debtor’s identification.
[1..1]
Or}
++++++++PrivateIdentification
<PrvtId>
[0..1]
+++++++++DateAndPlaceOfBirth
<DtAndPlcOfBirth>
[1..1]
++++++++++BirthDate
<BirthDt>
Ultimate debtor’s birth date.
[1..1]
++++++++++CityOfBirth
<CityOfBirth>
Ultimate debtor’s city of birth.
[1..1]
++++++++++CountryOfBirth
<CtryOfBirth>
Ultimate debtor’s country of birth.
[0..n]
+++++++++Other
<Othr>
[1..1]
++++++++++Identification
<Id>
Ultimate debtor’s identification.
[0..1]
++++++++++SchemeName
<SchmeNm>
[0..1]
++++++Creditor
<Cdtr>
Included for debit entries and for credit entries on the VIBAN / Indirect Scheme Participant account.
[0..1]
+++++++Name
<Nm>
Creditor’s name.
[0..1]
+++++++PostalAddress
<PstlAdr>
[0..1]
++++++++Country
<Ctry>
Creditor’s country ISO code.
[0..1]
++++++++AddressLine
<AdrLine>
Creditor’s address.
[0..1]
+++++++Identification
<Id>
If the account statement was requested for a VIBAN / Indirect Scheme Participant master account, this tag is empty for a credit transaction.
[1..1]
{Or
++++++++OrganisationIdentification
<OrgId>
[0..1]
+++++++++BICOrBEI
<BICOrBEI>
Creditor’s BIC or BEI.
[0..n]
+++++++++Other
<Othr>
[1..1]
++++++++++Identification
<Id>
Creditor’s identification.
[1..1]
Or}
++++++++PrivateIdentification
<PrvtId>
[0..1]
+++++++++DateAndPlaceOfBirth
<DtAndPlcOfBirth>
[1..1]
++++++++++BirthDate
<BirthDt>
Creditor’s birth date.
[1..1]
++++++++++CityOfBirth
<CityOfBirth>
Creditor’s city of birth.
[1..1]
++++++++++CountryOfBirth
<CtryOfBirth>
Creditor’s country of birth.
[0..n]
+++++++++Other
<Othr>
[1..1]
++++++++++Identification
<Id>
Creditor’s identification.
[0..1]
++++++++++SchemeName
<SchmeNm>
[0..1]
++++++CreditorAccount
<CdtrAcct>
Included for debit entries and for credit entries on the VIBAN / Indirect Scheme Participant account.
[1..1]
+++++++Identification
<Id>
[0..1]
{Or
++++++++IBAN
<IBAN>
Creditor’s IBAN. For UK Faster Payments (outgoing), this is included when the payment request also contained an IBAN.
[0..1]
Or}
++++++++Other
<Othr>
[1..1]
+++++++++Identification
<Id>
Creditor’s account number that is not an IBAN. For UK Faster Payments (outgoing), this is included when the payment request also contained a sort code and domestic account number. For Faster Payments (incoming), this is the UK sort code + account number (14 characters).
[0..1]
++++++UltimateCreditor
<UltmtCdtr>
[0..1]
+++++++Name
<Nm>
Ultimate creditor’s name.
[0..1]
+++++++Identification
<Id>
[1..1]
{Or
++++++++OrganisationIdentification
<OrgId>
[0..1]
+++++++++BICOrBEI
<BICOrBEI>
Ultimate creditor’s BIC or BEI.
[0..n]
+++++++++Other
<Othr>
[1..1]
++++++++++Identification
<Id>
Ultimate creditor’s identification.
[1..1]
Or}
++++++++PrivateIdentification
<PrvtId>
[0..1]
+++++++++DateAndPlaceOfBirth
<DtAndPlcOfBirth>
[1..1]
++++++++++BirthDate
<BirthDt>
Ultimate creditor’s birth date.
[1..1]
++++++++++CityOfBirth
<CityOfBirth>
Ultimate creditor’s city of birth.
[1..1]
++++++++++CountryOfBirth
<CtryOfBirth>
Ultimate creditor’s country of birth.
[0..n]
+++++++++Other
<Othr>
[1..1]
++++++++++Identification
<Id>
Ultimate creditor’s identification.
[0..1]
++++++++++SchemeName
<SchmeNm>
[0..1]
+++++RelatedAgents
<RltdAgts>
[0..1]
++++++DebtorAgent
<DbtrAgt>
[1..1]
+++++++FinancialInstitutionIdentification
<FinInstnId>
[0..1]
++++++++BIC
<BIC>
BIC of the debtor’s bank.
[0..1]
++++++++Name
<Nm>
Name of the debtor’s bank.
[0..1]
++++++CreditorAgent
<CdtrAgt>
[1..1]
+++++++FinancialInstitutionIdentification
<FinInstnId>
[0..1]
++++++++BIC
<BIC>
BIC of the creditor’s bank.
[0..1]
++++++++Name
<Nm>
Name of the creditor’s bank.
[0..1]
++++++IntermediaryAgent1
<IntrmyAgt1>
Not used.
[0..1]
++++++IntermediaryAgent2
<IntrmyAgt2>
Not used.
[0..1]
++++++IntermediaryAgent3
<IntrmyAgt3>
[1..1]
+++++++FinancialInstitutionIdentification
<FinInstnId>
[0..1]
++++++++BIC
<BIC>
BIC of the creditor’s correspondent bank.
[0..1]
++++++++Name
<Nm>
Name of the creditor’s correspondent bank.
[0..1]
+++++Purpose
<Purp>
[1..1]
Or}
++++++Proprietary
<Prtry>
[0..10]
+++++RelatedRemittanceInformation
<RltdRmtInf>
Not used.
[0..1]
+++++RemittanceInformation
<RmtInf>
[0..n]
++++++Unstructured
<Ustrd>
Payment description.
[0..n]
++++++Structured
<Strd>
[0..n]
+++++++CreditorReferenceInformation
<CdtrRefInf>
[0..1]
++++++++Type
<Tp>
[1..1]
+++++++++CodeOrProprietary
<CdOrPrtry>
[1..1]
{Or
++++++++++Code
<Cd>
SCOR
[1..1]
Or}
++++++++++Proprietary
<Prtry>
[0..1]
+++++++++Issuer
<Issr>
[0..1]
++++++++Reference
<Ref>
Payment reference number.
[0..1]
+++++ReturnInformation
<RtrInf>
Return information. Element is present when RvslInd is True. Provides details about the return, including the reason code (if available) and original payment reference.
[0..1]
++++++Reason
<Rsn>
[1..1]
{Or
+++++++Code
<Cd>
NARR if AdditionalInformation is filled.
[1..1]
Or}
+++++++Proprietary
<Prtry>
[0..n]
++++++AdditionalInformation
<AddtlInf>
Contains return reason code. The value is a scheme-specific code. See the codes in Payment Return Codes
[0..n]
++++++AdditionalInformation
<AddtlInf>
Contains original payment Account Servicer Reference.
The value follows the format ORIG:{reference}, for example: ORIG:C9512AB4B85A4410A73BA8E94DDED3A9.
Example
Sample statement containing:
two currencies
no pagination
Error codes
Service-specific errors
errStatement_NoAccess
No access to the account.
errStatement_PeriodLong
Period is too long.
errStatement_PeriodInvalid
From date cannot be later than to date.
Last updated
Was this helpful?