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.
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
[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' BankToCustomerStatement - client request POST https://connect.lhv.eu/account-statement; 'camt.052.001.06' BankToCustomerAccountReport - client request POST https://connect.lhv.eu/account-balance
[1..1]
++Account
<Acct>
[1..1]
+++Identification
<Id>
[1..1]
++++IBAN
<IBAN>
IBAN number to which the report request refers. When using Virtual/Agency account services - only master account IBAN must be used here. Virtual/Agency account is only displayed in the account statement report.
[1..1]
++AccountOwner
<AcctOwnr>
[1..1]
+++Party
<Pty>
Values are ignored.
[1..1]
++ReportingPeriod
<RptgPrd>
[1..1]
+++FromToDate
<FrToDt>
[1..1]
++++FromDate
<FrDt>
Account statement from date, ISO date format. FromDate cannot be later than ToDate. For camt.052.001.06 value is ignored and only current day is returned.
[1..1]
++++ToDate
<ToDt>
Account statement to date, ISO date format. For camt.052.001.06 value is ignored and only current day is returned.
[1..1]
+++FromToTime
<FrToTm>
Value is ignored if ReqdBalTp block not added or if ReqdBalTp.CdOrPrtry.Cd.Prtry = DATE. Used when Prtry = DATETIME
[1..1]
+++FromTime
<FrTm>
ISO datetime, inclusive.
[1..1]
+++ToTime
<ToTm>
ISO datetime, exclusive.
[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>
For Account Statement camt.053: 'DATE': return statement based on FromDate and ToDate only; FromTime and ToTime are ignored, 'DATETIME': return statement with FromTime and ToTime support. For Account Balance PAYMENT_LIMITS will also add Payments Limits info in the response.
Samples
Sample is requesting the account statement for account EE337700771001260958.
Use Prtry=DATE to query for full days.
FrToTm values have no impact on the result
Response
Headers
Content-Type
application/xml
X-Bank-Code
LHVUK, LHVEE
Body
Request accepted - no content
Response
Response message is created and can be requests by the Messages services - Messages Services
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 larger number of transactions pagination can be used - one Account Statement response receives more then one response in the queue. Then this optional block is used. 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>
[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>
LHVBEE22
[0..1]
+++++Name
<Nm>
LHV Pank
[0..1]
+++++PostalAddress
<PstlAdr>
[0..1]
++++++AddressType
<AdrTp>
BIZZ
[0..1]
++++++StreetName
<StrtNm>
Tartu mnt
[0..1]
++++++BuildingNumber
<BldgNb>
2
[0..1]
++++++PostCode
<PstCd>
10145
[0..1]
++++++TownName
<TwnNm>
Tallinn
[0..1]
++++++CountrySubdivision
<CtrySubDvsn>
Harjumaa
[0..1]
++++++Country
<Ctry>
EE
[0..1]
++RelatedAccount
<RltdAcct>
Not used.
[1..n]
++Balance
<Bal>
[1..1]
+++Type
<Tp>
[1..1]
++++CodeOrProprietary
<CdOrPrtry>
[1..1]
+++++Code
<Cd>
[0..1]
+++CreditLine
<CdtLine>
Not used.
[1..1]
+++Amount
<Amt>
Balance amount.
[1..1]
+++CreditDebitIndicator
<CdtDbtInd>
[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 ebtries 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).
[1..1]
+++CreditDebitIndicator
<CdtDbtInd>
[0..1]
+++ReversalIndicator
<RvslInd>
True (1) if credit transaction is return of payment
[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 with time.
[1..1]
+++AccountServicerReference
<AcctSvcrRef>
Unique payment ID assigned by the bank.
[1..1]
+++BankTransactionCode
<BkTxCd>
[1..1]
++++Domain
<Domn>
[1..1]
+++++Code
<Cd>
[1..1]
+++++Family
<Fmly>
[1..1]
++++++Code
<Cd>
[1..1]
++++++SubFamilyCode
<SubFmlyCd>
[0..1]
++++Proprietary
<Prtry>
[1..1]
+++++Code
<Cd>
[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 reference to the original payment initiation 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>
[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 account statement was requested for Virtual/Agency account master account this tag will be empty for 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>
[1..1]
+++++++++++Code
<Cd>
[0..1]
++++++DebtorAccount
<DbtrAcct>
If account statement was requested for Virtual/Agency account master account, Virtual/Agency account account number is displayed here for debit transaction.
[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 which is not IBAN. For Faster Payments (incoming): UK sort code + account nr (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>
[1..1]
+++++++++++Code
<Cd>
[0..1]
++++++Creditor
<Cdtr>
[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 account statement was requested for Virtual/Agency account master account this tag will be empty for 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>
[1..1]
+++++++++++Code
<Cd>
[0..1]
++++++CreditorAccount
<CdtrAcct>
If account statement was requested for Virtual/Agency account master account, Virtual/Agency account account number is displayed here for credit transaction
[1..1]
+++++++Identification
<Id>
[0..1]
{Or
++++++++IBAN
<IBAN>
Creditor’s IBAN. UK Faster Payments (outgoing) - when also payment request contained IBAN.
[0..1]
Or}
++++++++Other
<Othr>
[1..1]
+++++++++Identification
<Id>
Creditor’s account number which is not IBAN. UK Faster Payments (outgoing) - when also payment request contained sort code + domestic account nr. For Faster Payments (incoming): UK sort code + account nr (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>
[1..1]
+++++++++++Code
<Cd>
[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
++++++Code
<Cd>
[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.
[0..1]
++++++Reason
<Rsn>
[1..1]
{Or
+++++++Code
<Cd>
NARR if AdditionalInformation is filled.
[1..1]
Or}
+++++++Proprietary
<Prtry>
[0..n]
++++++AdditionalInformation
<AddtlInf>
Samples
Sample of a 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.
errStatement_RequestInvalid
Request message fails xsd validation.
Last updated
Was this helpful?