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.

Name	Value	Description
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

Name	Value	Description
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

Name	Value	Description
Content-Type	application/json	Format of the message body.
X-Bank-Code	LHVUK, LHVEE	LHV Bank entity.

Body

200 - list of webhook messages

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
    }
]

403 - error