List Events

Retrieve recent webhook events with optional filtering

Endpoint

GET /api/v1/events

Lists recent webhook events received from GitHub, optionally filtered by status.

Authentication

Requires a valid JWT token in cookies (obtained via GitHub OAuth).

Query Parameters

limit · integer · default: 20

Maximum number of events to return (1-100)

status · string

Filter by event status: pending, completed, or failed

Response

Returns an array of event objects, ordered by creation time (most recent first).

id · integer

Unique event identifier

event_type · string

GitHub event type (e.g., pull_request, push)

status · string

Processing status: pending, completed, or failed

payload · object

Raw GitHub webhook payload (JSON string)

created_at · string

ISO 8601 timestamp when event was received

processed_at · string

ISO 8601 timestamp when event processing completed (null if pending)

Example Request

cURL

curl https://your-backend.railway.app/api/v1/events?limit=10&status=completed \
  -H "Cookie: access_token=your_jwt_token"

Example Response

[
  {
    "id": 42,
    "event_type": "pull_request",
    "status": "completed",
    "payload": "{\"action\":\"opened\",\"number\":123,...}",
    "created_at": "2026-03-10T14:30:00Z",
    "processed_at": "2026-03-10T14:30:15Z"
  },
  {
    "id": 41,
    "event_type": "pull_request",
    "status": "completed",
    "payload": "{\"action\":\"synchronize\",\"number\":122,...}",
    "created_at": "2026-03-10T12:15:00Z",
    "processed_at": "2026-03-10T12:15:12Z"
  }
]

Use Cases

• Monitoring: Track webhook delivery and processing success rates
• Debugging: Identify failed events that need investigation
• Analytics: Analyze event volume and types over time
• Auditing: Review webhook activity for compliance

Related Endpoints

Event Details

Get detailed information about a specific event

Reviews List

View PR reviews generated from events