Skip to main content

Notification Service

Handles real-time notifications and event tracking.

Base URL: https://api.ledgerlink.ai/v1

Event Monitoring​

The notification service tracks various transaction and system events:

  • Payment request created
  • Payment accepted
  • Payment rejected
  • Payment executed
  • Payment cancelled
  • Transaction status updates

Event Polling​

You can poll for recent events using the events endpoint:

GET /events

Query Parameters:

  • limit (integer, optional): Number of events to return (default: 20, max: 100)
  • offset (integer, optional): Number of events to skip (default: 0)
  • since (string, optional): ISO 8601 timestamp to filter events after
  • type (string, optional): Filter by event type

Response:

{
  "data": [
    {
      "id": "event_uuid",
      "type": "payment.created",
      "timestamp": "2025-06-18T10:00:00Z",
      "data": {
        "transactionId": "uuid",
        "type": "TRANSFER",
        "status": "PENDING",
        "amount": "100.00",
        "currency": "USD",
        "fromParticipant": "Sender Bank",
        "toParticipant": "Receiver Bank"
      }
    }
  ],
  "pageInfo": {
    "limit": 20,
    "offset": 0,
    "total": 1
  }
}

Error Handling​

All services return consistent error responses. See our Error Handling Guide for details on error codes and resolution strategies.