Skip to main content

TelemetryReceiptEvent

Normalized telemetry receipt published to NATS JetStream subject telemetry.receipts.

bounce_reasonstring | nullnullable

Diagnostic failure message or bounce reason.

message_idstringrequired

Upstream message identifier.

Example: 49a3999c-0ce1-4ea6-ab68-afcd6dc2e794
providerstringrequired

External delivery provider reporting the receipt.

Example: resend
raw_event_idstringrequired

Internal Nerve receipt event identifier (dlr_...).

Example: dlr_1a2b3c4d5e6f70819
recipientstringrequired

Recipient address or token.

Example: user@example.com
statusstringrequired

Canonical receipt status (DELIVERED, BOUNCED_HARD, BOUNCED_SOFT, COMPLAINED).

Example: DELIVERED
timestampstringrequired

ISO 8601 / RFC 3339 timestamp string.

Example: 2026-09-17T02:22:00Z
workspace_idstring | nullnullable

Multi-tenant workspace identifier if known.

TelemetryReceiptEvent
{
  "bounce_reason": "string",
  "message_id": "49a3999c-0ce1-4ea6-ab68-afcd6dc2e794",
  "provider": "resend",
  "raw_event_id": "dlr_1a2b3c4d5e6f70819",
  "recipient": "user@example.com",
  "status": "DELIVERED",
  "timestamp": "2026-09-17T02:22:00Z",
  "workspace_id": "string"
}