API Reference / REST API

REST API

Coming Soon

The Paggio REST API is currently in development. API keys can be generated in Settings → API Keys and will be ready to use when the API launches.

Not yet available:The endpoints shown below are a preview of the planned API surface. None of these routes are live yet. The current app uses session-based auth internally — public API key access is coming in a future release.

Planned endpoints

Base URL: https://paggio.dev/api/v1

EndpointsPreview — not yet available

GET/api/v1/eventsList webhook events

GET/api/v1/events/:idGet a single event with full payload

POST/api/v1/events/:id/replayReplay an event to any URL

GET/api/v1/endpointsList your webhook endpoints

POST/api/v1/endpointsCreate a new endpoint

DELETE/api/v1/endpoints/:idDelete an endpoint

Authentication (preview)

API requests will be authenticated with a bearer token generated from Settings → API Keys. Keys will be prefixed with pk_live_.

Preview — not yet available

bash

curl https://paggio.dev/api/v1/events \
  -H "Authorization: Bearer pk_live_abc123def456..." \
  -H "Content-Type: application/json"

GET /api/v1/events

List webhook events with optional filtering.

Preview — not yet available

bash

curl "https://paggio.dev/api/v1/events?status=failed&limit=20" \
  -H "Authorization: Bearer pk_live_..."

Preview — not yet available

json

{
  "data": [
    {
      "id": "550e8400-e29b-41d4-a716-446655440000",
      "source": "stripe",
      "event_type": "payment_intent.succeeded",
      "status": "delivered",
      "latency_ms": 142,
      "received_at": "2024-03-10T15:23:41.000Z"
    }
  ],
  "meta": {
    "total": 142,
    "limit": 20,
    "offset": 0
  }
}

POST /api/v1/events/:id/replay

Replay an event to any destination URL.

Preview — not yet available

bash

curl -X POST "https://paggio.dev/api/v1/events/550e8400.../replay" \
  -H "Authorization: Bearer pk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"destination_url": "https://your-app.com/webhook"}'

Preview — not yet available

json

{
  "id": "replay-attempt-uuid",
  "status": "delivered",
  "response_status": 200,
  "latency_ms": 87,
  "destination_url": "https://your-app.com/webhook",
  "replayed_at": "2024-03-10T16:00:00.000Z"
}

Want early API access?

Generate your API key now in Settings — it'll be ready to use the moment the API launches.

Go to Settings → API Keys