Skip to main content

​
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 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

Event Details

Get detailed information about a specific event

Reviews List

View PR reviews generated from events

Build docs developers (and LLMs) love

Get started for freeTalk to us