Get Transaction by Reference

Service to retrieve detailed information about a specific transaction using the account number (IBAN) and the Account Servicer Reference.

Service Description

This service provides a way to check the status or details of a payment without fetching a full account statement. It is synchronous and optimized for recent transactions (within the last 14 days). The service is available only for payments processed in LHV Bank UK.

When to Use:

• To track the status of a payment without requesting an account statement.

• As a fallback when credit/debit notifications are unavailable.

• For reconciliation, debugging, or investigation purposes.

Request

GET https://connect.lhv.com/accounts/{accountNumber}/transactions/{accountServicerReference}

Path Parameters

Name	Description
accountNumber	The IBAN of the account held with LHV Bank. Use the master account, virtual IBANs (VIBANs) and indirect scheme participant accounts are not supported.
accountServicerReference	The unique payment ID assigned by LHV Bank. This reference is included in the payment status report message (pain.002), account statement (camt.053), and credit/debit notification (camt.054). Example: 80FA866CFC3F482CB74EFE0A047DA86D. The value can be provided with or without hyphens.

Headers

Applicable for service providers and service provider users.

Name	Description
Client-Code	customer value
Client-Country	customer value

Body

This request doesn't have a body.

Response

Successful Response

If the payment is found, the response includes full payment details such as status, amount, counterparties, and payment description.

• For debit transactions, receiver (creditor) details are included.

• For credit transactions, sender (debtor) details are included.

• For virtual account (VIBAN) payments, if either the sender or receiver was a VIBAN, the field IsVirtualAccountPayment: true is returned and the related virtual account details are added to the response.

No Transaction Found

If the transaction cannot be found, a 404 response is returned.

This may happen if:

• payment has not yet been processed (no reservation exists),

  • payment has been cancelled

• the account servicer reference is invalid, or

• the payment is older than the 14-day lookup window.

Payment Status

Statuses in the response are simplified for clarity:

• Pending – The payment is being processed but has not yet been booked on the account.

• Booked – The payment has been fully processed and the account has been debited or credited.

Examples

200 - payment status and details

{
  "EndToEndId" : "EndToEndId123456",
  "IsVirtualAccountPayment" : false,
  "Amount" : {
    "Amount" : "1.00",
    "Currency" : "GBP"
  },
  "CreditDebitIndicator" : "Debit",
  "Status" : "Booked",
  "BookingDateTime" : "2025-10-31",
  "ValueDateTime" : "2025-10-31",
  "CreditorAgent" : {
    "SchemeName" : "BIC",
    "Identification" : "LHVBGB2LXXX"
  },
  "CreditorAccount" : {
    "Identification" : "GB80LHVB04030700012345",
    "Name" : "Connect Demo Company"
  },
  "TransactionId" : "A5A7DFE0-C65A-4F89-AA4B-EBE944E749E7"
}

404 - payment not found

"No transaction record was found. This may happen if the account servicer reference is invalid, the payment is cancelled or older than 14 days, or it is scheduled for a future date"

403 - no rights to account

"Access denied for the account associated with this IBAN"