Account Statement
Account Statement service description
Account Statement - 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 request 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 affect only Statements or Balances responses.
Headers
Name | Value |
---|---|
Content-Type |
|
Client-Code |
|
Client-Country |
|
Body
XML structure description:
Message root
INDEX | MESSAGE ELEMENT | XML TAG |
---|---|---|
[1..1] | MessageRoot | <AcctRptgReq> |
Group header
MULT. | MESSAGE ELEMENT | XML TAG | DESCRIPTION |
---|---|---|---|
[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
Name | Value |
---|---|
Content-Type |
|
X-Bank-Code |
|
Body
Request accepted - no content
Response message
Response message is created and can be requests by the Messages services - Messages Services
HTTP Header Message-Response-Type: ACCOUNT_STATEMENT
Body
Message root
INDEX | MESSAGE ELEMENT | XML TAG |
---|---|---|
[1..1] | MessageRoot | <BkToCstmrStmt> |
Group header
MULT. | MESSAGE ELEMENT | XML TAG | DESCRIPTION |
---|---|---|---|
[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
MULT. | OR | MESSAGE ELEMENT | XML TAG | DESCRIPTION |
---|---|---|---|---|
[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> | See the codes in Code Set: Balance. | |
[0..1] | +++CreditLine | <CdtLine> | Not used. | |
[1..1] | +++Amount | <Amt> | Balance amount. | |
[1..1] | +++CreditDebitIndicator | <CdtDbtInd> | See the codes in Code Set: Credit and Debit Code. | |
[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> | See the codes in Code Set: Credit and Debit Code. | |
[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> | See the codes in Code Set: Bank Transaction Codes. | |
[1..1] | +++++Family | <Fmly> | ||
[1..1] | ++++++Code | <Cd> | See the codes in Code Set: Bank Transaction Codes. | |
[1..1] | ++++++SubFamilyCode | <SubFmlyCd> | See the codes in Code Set: Bank Transaction Codes. | |
[0..1] | ++++Proprietary | <Prtry> | ||
[1..1] | +++++Code | <Cd> | Payment scheme code - Code Set: Payment scheme. | |
[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> | See the supported values in Code Set: Private Person Identification. | |
[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> | See the supported values in Code Set: Private Person Identification. | |
[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> | See the supported values in Code Set: Private Person Identification. | |
[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> | See the supported values in Code Set: Private Person Identification. | |
[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> | See the codes in Code Set: Purpose. |
[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> | Used with Reason/Code NARR. For returned payment reference to original payment message pain.001.001.09 PmtInfId value. Additional rows with format CD:NNNNNNNN refer to payment scheme specific return codes. |
Samples
Sample of a statement containing:
two currencies
no pagination
Error codes
Service specific errors
ERROR CODE | DESCRIPTION |
---|---|
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