Account Statement
Account Statement service description
Last updated
Account Statement service description
Last updated
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.
| Name | Value |
|---|---|
XML structure description:
Message root
| INDEX | MESSAGE ELEMENT | XML TAG |
|---|---|---|
Group header
| MULT. | MESSAGE ELEMENT | XML TAG | DESCRIPTION |
|---|---|---|---|
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
<?xml version="1.0" encoding="UTF-8"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:camt.060.001.03">
<AcctRptgReq>
<GrpHdr>
<MsgId>MSGIDLHVTEST01</MsgId>
<CreDtTm>2019-11-14T16:15:07.617</CreDtTm>
</GrpHdr>
<RptgReq>
<ReqdMsgNmId>camt.053.001.02</ReqdMsgNmId>
<Acct>
<Id>
<IBAN>EE337700771001260958</IBAN>
</Id>
</Acct>
<AcctOwnr>
<Pty/>
</AcctOwnr>
<RptgPrd>
<FrToDt>
<FrDt>2019-11-14</FrDt>
<ToDt>2019-11-14</ToDt>
</FrToDt>
<FrToTm>
<FrTm>16:00:00+02:00</FrTm>
<ToTm>17:00:00+02:00</ToTm>
</FrToTm>
<Tp>ALLL</Tp>
</RptgPrd>
<ReqdBalTp>
<CdOrPrtry>
<Prtry>DATE</Prtry>
</CdOrPrtry>
</ReqdBalTp>
</RptgReq>
</AcctRptgReq>
</Document>Sample is requesting the account statement for account EE337700771001260958.
Use Prtry=DATETIME to query for precise time range
FrToTm values are used
<?xml version="1.0" encoding="UTF-8"?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:camt.060.001.03">
<AcctRptgReq>
<GrpHdr>
<MsgId>MSGIDLHVTEST01</MsgId>
<CreDtTm>2019-11-14T16:15:07.617</CreDtTm>
</GrpHdr>
<RptgReq>
<ReqdMsgNmId>camt.053.001.02</ReqdMsgNmId>
<Acct>
<Id>
<IBAN>EE337700771001260958</IBAN>
</Id>
</Acct>
<AcctOwnr>
<Pty/>
</AcctOwnr>
<RptgPrd>
<FrToDt>
<FrDt>2019-11-14</FrDt>
<ToDt>2019-11-14</ToDt>
</FrToDt>
<FrToTm>
<FrTm>16:00:00+02:00</FrTm>
<ToTm>17:00:00+02:00</ToTm>
</FrToTm>
<Tp>ALLL</Tp>
</RptgPrd>
<ReqdBalTp>
<CdOrPrtry>
<Prtry>DATETIME</Prtry>
</CdOrPrtry>
</ReqdBalTp>
</RptgReq>
</AcctRptgReq>
</Document>Headers
Request accepted - no content
Error code and description
<Errors>
<Error>
<ErrorCode>FORBIDDEN</ErrorCode>
<Description>User doesn't exist</Description>
</Error>
</Errors>Response message is created and can be requests by the Messages services - Messages Services
HTTP Header Message-Response-Type: ACCOUNT_STATEMENT
Message root
Group header
Statement
Sample of a statement containing:
two currencies
no pagination
<?xml version="1.0" ?>
<Document xmlns="urn:iso:std:iso:20022:tech:xsd:camt.053.001.02" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xsi:schemaLocation="urn:iso:std:iso:20022:tech:xsd:camt.053.001.02 camt.053.001.02.xsd">
<BkToCstmrStmt>
<GrpHdr>
<MsgId>10001115</MsgId>
<CreDtTm>2016-03-15T13:04:55.123</CreDtTm>
</GrpHdr>
<Stmt>
<Id>10001115EUR</Id>
<CreDtTm>2016-03-15T13:04:55</CreDtTm>
<FrToDt>
<FrDtTm>2016-03-10T00:00:00</FrDtTm>
<ToDtTm>2016-03-15T13:04:55</ToDtTm>
</FrToDt>
<Acct>
<Id>
<IBAN>EE457700771000676899</IBAN>
</Id>
<Ccy>EUR</Ccy>
<Svcr>
<FinInstnId>
<BIC>LHVBEE20XXX</BIC>
<Nm>AS LHV Pank</Nm>
<PstlAdr>
<AdrTp>BIZZ</AdrTp>
<StrtNm>Tartu mnt.</StrtNm>
<BldgNb>2</BldgNb>
<PstCd>10145</PstCd>
<TwnNm>Tallinn</TwnNm>
<CtrySubDvsn>Harjumaa</CtrySubDvsn>
<Ctry>EE</Ctry>
</PstlAdr>
</FinInstnId>
</Svcr>
</Acct>
<Bal>
<Tp>
<CdOrPrtry>
<Cd>OPBD</Cd>
</CdOrPrtry>
</Tp>
<Amt Ccy="EUR">4497512.65</Amt>
<CdtDbtInd>CRDT</CdtDbtInd>
<Dt>
<Dt>2016-03-10</Dt>
</Dt>
</Bal>
<Bal>
<Tp>
<CdOrPrtry>
<Cd>CLBD</Cd>
</CdOrPrtry>
</Tp>
<Amt Ccy="EUR">4497505.65</Amt>
<CdtDbtInd>CRDT</CdtDbtInd>
<Dt>
<Dt>2016-03-15</Dt>
</Dt>
</Bal>
<TxsSummry>
<TtlCdtNtries>
<NbOfNtries>0</NbOfNtries>
<Sum>0.00</Sum>
</TtlCdtNtries>
<TtlDbtNtries>
<NbOfNtries>2</NbOfNtries>
<Sum>2.00</Sum>
</TtlDbtNtries>
</TxsSummry>
<Ntry>
<Amt Ccy="EUR">1.00</Amt>
<CdtDbtInd>DBIT</CdtDbtInd>
<Sts>BOOK</Sts>
<BookgDt>
<Dt>2016-03-10</Dt>
</BookgDt>
<ValDt>
<DtTm>2016-03-10T10:11:53.000</DtTm>
</ValDt>
<AcctSvcrRef>D9C8845A4BBAEA11910E00155DBDB777</AcctSvcrRef>
<BkTxCd>
<Domn>
<Cd>PMNT</Cd>
<Fmly>
<Cd>CCRD</Cd>
<SubFmlyCd>FEES</SubFmlyCd>
</Fmly>
</Domn>
<Prtry>
<Cd>INTERNAL</Cd>
</Prtry>
</BkTxCd>
<NtryDtls>
<TxDtls>
<Refs>
<AcctSvcrRef>D9C8845A4BBAEA11910E00155DBDB777</AcctSvcrRef>
</Refs>
<AmtDtls>
<InstdAmt>
<Amt Ccy="EUR">1.00</Amt>
</InstdAmt>
<TxAmt>
<Amt Ccy="EUR">1.00</Amt>
</TxAmt>
</AmtDtls>
<RltdPties>
<Dbtr></Dbtr>
<Cdtr></Cdtr>
</RltdPties>
<RltdAgts></RltdAgts>
<RmtInf>
<Ustrd>Card (..6748) monthly fee</Ustrd>
</RmtInf>
</TxDtls>
</NtryDtls>
</Ntry>
<Ntry>
<Amt Ccy="EUR">1.00</Amt>
<CdtDbtInd>DBIT</CdtDbtInd>
<Sts>BOOK</Sts>
<BookgDt>
<Dt>2016-03-11</Dt>
</BookgDt>
<ValDt>
<DtTm>2016-03-11T10:11:53.000</DtTm>
</ValDt>
<AcctSvcrRef>D9C8845A4BBAEA11910E00155DBDB779</AcctSvcrRef>
<BkTxCd>
<Domn>
<Cd>PMNT</Cd>
<Fmly>
<Cd>ICDT</Cd>
<SubFmlyCd>OTHR</SubFmlyCd>
</Fmly>
</Domn>
<Prtry>
<Cd>INTERNAL</Cd>
</Prtry>
</BkTxCd>
<NtryDtls>
<TxDtls>
<Refs>
<AcctSvcrRef>D9C8845A4BBAEA11910E00155DBDB779</AcctSvcrRef>
<InstrId>94</InstrId>
</Refs>
<AmtDtls>
<InstdAmt>
<Amt Ccy="EUR">1.00</Amt>
</InstdAmt>
<TxAmt>
<Amt Ccy="EUR">1.00</Amt>
</TxAmt>
</AmtDtls>
<RltdPties>
<Dbtr>
<Nm>Silver Kullassepp</Nm>
<PstlAdr>
<Ctry>EE</Ctry>
</PstlAdr>
<Id>
<PrvtId>
<Othr>
<Id>48107090295</Id>
<SchmeNm>
<Cd>NIDN</Cd>
</SchmeNm>
</Othr>
</PrvtId>
</Id>
</Dbtr>
<DbtrAcct>
<Id>
<IBAN>EE457700771000676899</IBAN>
</Id>
</DbtrAcct>
<Cdtr>
<Nm>Test Client</Nm>
</Cdtr>
<CdtrAcct>
<Id>
<IBAN>EE867700771000681884</IBAN>
</Id>
</CdtrAcct>
</RltdPties>
<RltdAgts>
<DbtrAgt>
<FinInstnId>
<BIC>LHVBEE20XXX</BIC>
<Nm>AS LHV Pank</Nm>
</FinInstnId>
</DbtrAgt>
<CdtrAgt>
<FinInstnId>
<BIC>LHVBEE20XXX</BIC>
<Nm>AS LHV Pank</Nm>
</FinInstnId>
</CdtrAgt>
</RltdAgts>
<RmtInf>
<Ustrd>EUR payment</Ustrd>
</RmtInf>
</TxDtls>
</NtryDtls>
</Ntry>
</Stmt>
<Stmt>
<Id>10001115USD</Id>
<CreDtTm>2016-03-15T13:04:55</CreDtTm>
<FrToDt>
<FrDtTm>2016-03-10T00:00:00</FrDtTm>
<ToDtTm>2016-03-15T13:04:55</ToDtTm>
</FrToDt>
<Acct>
<Id>
<IBAN>EE457700771000676899</IBAN>
</Id>
<Ccy>USD</Ccy>
<Svcr>
<FinInstnId>
<BIC>LHVBEE20XXX</BIC>
<Nm>AS LHV Pank</Nm>
<PstlAdr>
<AdrTp>BIZZ</AdrTp>
<StrtNm>Tartu mnt.</StrtNm>
<BldgNb>2</BldgNb>
<PstCd>10145</PstCd>
<TwnNm>Tallinn</TwnNm>
<CtrySubDvsn>Harjumaa</CtrySubDvsn>
<Ctry>EE</Ctry>
</PstlAdr>
</FinInstnId>
</Svcr>
</Acct>
<Bal>
<Tp>
<CdOrPrtry>
<Cd>OPBD</Cd>
</CdOrPrtry>
</Tp>
<Amt Ccy="USD">1216.13</Amt>
<CdtDbtInd>CRDT</CdtDbtInd>
<Dt>
<Dt>2016-03-10</Dt>
</Dt>
</Bal>
<Bal>
<Tp>
<CdOrPrtry>
<Cd>CLBD</Cd>
</CdOrPrtry>
</Tp>
<Amt Ccy="USD">1215.13</Amt>
<CdtDbtInd>CRDT</CdtDbtInd>
<Dt>
<Dt>2016-03-15</Dt>
</Dt>
</Bal>
<TxsSummry>
<TtlCdtNtries>
<NbOfNtries>0</NbOfNtries>
<Sum>0.00</Sum>
</TtlCdtNtries>
<TtlDbtNtries>
<NbOfNtries>1</NbOfNtries>
<Sum>1.00</Sum>
</TtlDbtNtries>
</TxsSummry>
<Ntry>
<Amt Ccy="USD">1.00</Amt>
<CdtDbtInd>DBIT</CdtDbtInd>
<Sts>BOOK</Sts>
<BookgDt>
<Dt>2016-03-15</Dt>
</BookgDt>
<ValDt>
<DtTm>2016-03-15T10:11:53.000</DtTm>
</ValDt>
<AcctSvcrRef>D9C8845A4BBAEA11910E00155DBDB781</AcctSvcrRef>
<BkTxCd>
<Domn>
<Cd>PMNT</Cd>
<Fmly>
<Cd>ICDT</Cd>
<SubFmlyCd>OTHR</SubFmlyCd>
</Fmly>
</Domn>
<Prtry>
<Cd>SWIFT</Cd>
</Prtry>
</BkTxCd>
<NtryDtls>
<TxDtls>
<Refs>
<AcctSvcrRef>D9C8845A4BBAEA11910E00155DBDB781</AcctSvcrRef>
<InstrId>17793</InstrId>
</Refs>
<AmtDtls>
<InstdAmt>
<Amt Ccy="USD">1.00</Amt>
</InstdAmt>
<TxAmt>
<Amt Ccy="USD">1.00</Amt>
</TxAmt>
</AmtDtls>
<RltdPties>
<Dbtr>
<Nm>Silver Kullassepp</Nm>
<PstlAdr>
<Ctry>EE</Ctry>
<AdrLine>Tartu mnt, Tallinn, 11111</AdrLine>
</PstlAdr>
</Dbtr>
<DbtrAcct>
<Id>
<IBAN>EE457700771000676899</IBAN>
</Id>
</DbtrAcct>
<Cdtr>
<Nm>John Smith</Nm>
</Cdtr>
<CdtrAcct>
<Id>
<Othr>
<Id>440532013000</Id>
</Othr>
</Id>
</CdtrAcct>
</RltdPties>
<RltdAgts>
<DbtrAgt>
<FinInstnId>
<BIC>LHVBEE20XXX</BIC>
<Nm>AS LHV Pank</Nm>
</FinInstnId>
</DbtrAgt>
<CdtrAgt>
<FinInstnId>
<BIC>DEUTDEBBXXY</BIC>
</FinInstnId>
</CdtrAgt>
</RltdAgts>
<RmtInf>
<Ustrd>USD payment</Ustrd>
</RmtInf>
</TxDtls>
</NtryDtls>
</Ntry>
</Stmt>
</BkToCstmrStmt>
</Document>Error codes
Service specific errors
| Name | Value |
|---|---|
| INDEX | MESSAGE ELEMENT | XML TAG |
|---|---|---|
| MULT. | MESSAGE ELEMENT | XML TAG | DESCRIPTION |
|---|---|---|---|
| MULT. | OR | MESSAGE ELEMENT | XML TAG | DESCRIPTION |
|---|---|---|---|---|
| ERROR CODE | DESCRIPTION |
|---|---|