Events API

List Events

GET /admin/events

Query Parameters:

Parameter	Type	Description
app_key	string	Filter by application key
provider	string	Filter by provider name
status	string	Filter by event status (received, enqueued, processed, failed, dead, rejected)
delivery_status	string	Filter by delivery status (pending, delivered, failed)
event_type	string	Filter by event type
account_slug	string	Filter by account slug
external_id	string	Filter by external ID
since	datetime	Events received after this time (ISO 8601)
until	datetime	Events received before this time (ISO 8601)
limit	integer	Max results (default: 100, max: 1000)
offset	integer	Pagination offset

Example:

curl "https://ingest.transyt.com/admin/events?provider=stripe&status=failed&limit=50" \
  -H "X-Admin-Token: YOUR_ADMIN_TOKEN"

Get Event Filters

Returns distinct values for building filter UIs:

GET /admin/events/filters

Response:

{
  "providers": ["stripe", "mailgun", "signalwire"],
  "event_types": ["charge.succeeded", "charge.failed", "email.delivered"],
  "account_slugs": ["my-app", "staging"],
  "statuses": ["received", "processed", "failed"]
}

Get Event Details

GET /admin/events/{event_id}

Returns the full event including payload, headers, delivery history, and all metadata.

Example:

curl https://ingest.transyt.com/admin/events/{event_id} \
  -H "X-Admin-Token: YOUR_ADMIN_TOKEN"

Replay Event

Re-delivers the event using the original payload:

POST /admin/events/{event_id}/replay

Example:

curl -X POST https://ingest.transyt.com/admin/events/{event_id}/replay \
  -H "X-Admin-Token: YOUR_ADMIN_TOKEN"

Replay All Failed Events

POST /admin/events/replay-failed

Query Parameters:

Parameter	Type	Description
app_key	string	Filter by application key
provider	string	Filter by provider name

Example:

curl -X POST "https://ingest.transyt.com/admin/events/replay-failed?provider=stripe" \
  -H "X-Admin-Token: YOUR_ADMIN_TOKEN"

Acknowledge Event

Mark an event as processed by your consumer:

POST /admin/events/{event_id}/ack

Fail Event

Mark an event as failed, with optional error message:

POST /admin/events/{event_id}/fail

Request Body:

Field	Type	Description
error	string	Error message
dead	boolean	Mark as dead (no more retries)

Example:

curl -X POST https://ingest.transyt.com/admin/events/{event_id}/fail \
  -H "X-Admin-Token: YOUR_ADMIN_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"error": "Invalid data format", "dead": true}'