API ReferenceEvent Triggers
List events
GET /events
List events
List events.
https://api.edgecron.com/v1/events
Authentication required
Send `X-Key-ID`, `X-Timestamp`, and `X-Signature` with every request. The signature is lowercase hex HMAC-SHA256 over `timestamp + "\n" + payload`.
Parameters
| Parameters | In | Type | Required | Description |
|---|---|---|---|---|
page | query | integer | No | Default: 1. |
page_size | query | integer | No | Default: 20. |
event_name | query | string | No | - |
status | query | string | No | Current lifecycle state. |
Request body
This endpoint does not require a JSON request body.
Response
All successful responses use the EdgeCron API envelope.
{
"code": 0,
"message": "success",
"request_id": "req_abc123",
"data": {
"total": 1,
"page": 1,
"page_size": 20,
"items": [
{
"id": 101,
"app_id": "app_123",
"event_name": "invoice.paid",
"event_key": "tenant-a",
"payload": {},
"status": "string",
"created_at": "2026-07-01T12:00:00Z"
}
]
}
}Schema
| Parameters | Type | Required | Description |
|---|---|---|---|
id | integer | No | Resource identifier. |
app_id | string | No | Application identifier. |
event_name | string | No | - |
event_key | string | No | - |
payload | object | No | JSON payload forwarded to the target endpoint. |
status | string | No | Current lifecycle state. |
created_at | string (date-time) | No | Creation timestamp. |