Get list of webhook messages
API enables retrival of previously sent webhook messages.
Service Description
This service provides access to previously sent webhook messages. It returns a list of webhook responses with optional filtering by type, status and date. Each entry includes summary data and delivery status, excluding full-body content and metadata.
Request
GET https://connect.lhv.com/notifications/history
Parameters
All parameters are optional.
offset
integer
The index from which to begin retrieving record. Default is 0.
limit
integer
The number of records per response. Default is 100.
eventId
string
UUID of the webhook message.
status
integer
Webhook message status (SUCCESS, FAILED, RETRY_PENDING ).
startDate
string
YYYY-MM-DD Filter messages created on or after this date.
endDate
string
YYYY-MM-DD Filter messages created on or before this date.
serviceProvider
true / false or 1/0
Can be used when the Service Provider’s own value is set in Client-Code.
Values: 1/true (filter on) or 0/false (filter off).
When enabled, only messages belonging to the Service Provider are returned. By default, if Client-Code refers to the Service Provider, messages from all related customers are included.
This header has no effect if Client-Code does not belong to a Service Provider.
responseType
string
Filters results by specific webhook message type. Accepts any valid response type value (e.g., ACCOUNT_STATEMENT, CREDIT_DEBIT_NOTIFICATION, PAYMENT).
Headers
Client-Code
customer value
Available to Service Providers only. Specifies the company registration code of either the Service Provider or its customer.
When the Service Provider’s own code is used, messages for related customers are included by default.
To return only the Service Provider’s own messages, set the serviceProvider filter to true.
Client-Country
customer value
Available to Service Providers only. Must correspond to the country associated with the specified Client-Code.
Response
Header
Content-Type
application/json
Format of the message body.
X-Bank-Code
LHVUK, LHVEE
LHV Bank entity.
Body
OK
[
{
"message": {
"eventId": "1b889bc6-b719-4b7d-aa81-2afa7925363f",
"eventTimestamp": "2025-09-05T05:01:03.253614+01:00",
"subscriptionReference": "2e11f643-61d7-470a-b63c-c9e5bc7bc296",
"messageResponseId": "RES4ca2fed81ebd49d39fc8ab7e537f6cff",
"messageRequestId": "REQ5104072b7d95482197422b205409b4de",
"messageType": "ACCOUNT_STATEMENT",
"messageCreatedTime": "2025-09-05T05:01:03.253614+01:00",
"regCode": "12340001",
"regCodeIssuer": "GB",
"bankCode": "LHVUK"
},
"status": "SUCCESS",
"retriesAttempted": 0,
"httpStatus": 200,
"responseContentLength": 23,
"latencyMs": 56
},
{
"message": {
"eventId": "2e354713-e68a-4613-aca1-2d5153602615",
"eventTimestamp": "2025-09-05T05:01:02.566724+01:00",
"subscriptionReference": "3b11f643-61d7-470a-b63c-c9e5bc7bc296",
"messageResponseId": "RES04d0b464100140eba617e8c6ce29a065",
"messageRequestId": "REQfd5ddff91bb3431a862cba3c6ba5bec9",
"messageType": "ACCOUNT_BALANCE",
"messageCreatedTime": "2025-09-05T05:01:02.566724+01:00",
"regCode": "12340001",
"regCodeIssuer": "GB",
"bankCode": "LHVUK"
},
"status": "SUCCESS",
"retriesAttempted": 0,
"httpStatus": 200,
"responseContentLength": 23,
"latencyMs": 49
}
]Last updated
Was this helpful?