Events

The Events API allows you to query events emitted by the Galliun Payment Protocol smart contracts.

Get All Events

GET /events

Retrieves a paginated list of events with filtering options.

Query Parameters

Parameter	Type	Description
page	number	Page number (min: 1, default: 1)
limit	number	Items per page (max: 100, default: 10)
eventType	string	Filter by event type
transactionDigest	string	Filter by transaction digest
packageId	string	Filter by package ID
moduleName	string	Filter by module name
functionName	string	Filter by function name
search	string	Search events (min: 3 chars)
sortBy	string	Sort field (CREATED_AT, EVENT_TYPE, etc.)
sortOrder	string	Sort order (ASC/DESC)

Event Types

• BILL_CREATED

• BILL_PAYMENT_MADE

• BILL_PAYMENT_CLAIMED

• BILL_PAYMENT_REFUNDED

• BILL_PAYMENT_FAILED

• BILL_CANCELLED

• PAYMENT_REQUEST_CREATED

• PAYMENT_REQUEST_PAID

• PAYMENT_REQUEST_FAILED

• PRODUCT_CREATED

• PRODUCT_UPDATED

• PRODUCT_PURCHASED

Response

{
	"data": [
		{
			"id": "string",
			"transactionDigest": "string",
			"eventType": "BILL_CREATED",
			"moduleName": "string",
			"data": {
				// Event-specific data
			},
			"checkpointSequenceNumber": 0,
			"timestampMs": 0,
			"createdAt": "2024-01-01T00:00:00Z"
		}
	],
	"meta": {
		"page": 1,
		"limit": 10,
		"total": 100
	}
}

Example Requests

Get Latest Events

GET /events?page=1&limit=10&sortBy=CREATED_AT&sortOrder=DESC

Filter by Event Type

GET /events?eventType=BILL_CREATED

Search Events

GET /events?search=payment&eventType=BILL_PAYMENT_MADE

Error Responses

Status	Description
400	Invalid parameters
401	Unauthorized
429	Too many requests
500	Server error