pass.window_closed

When this fires

A scheduled access window reached its end time. Everyone who held it has been removed from the plan's Telegram resources. For a single-window pass that also ends the purchase — one purchase buys one window, so there is no next window to roll into. For a Pass Series holder only this date's access is stripped; the subscription ends only when the window that closed was the last date they held.

This also fires for a window that never opened because the worker was unavailable for its entire span. Such a window is closed rather than opened late, so nobody is admitted to a window that has already finished.

Required ability

project-subscription-plan:view — token must carry this at mint time to subscribe an endpoint to this event.

Payload

{
  "id": "evt_01HX...",
  "type": "pass.window_closed",
  "created_at": "2026-09-21T03:00:02Z",
  "api_version": "2026-05-01",
  "project_id": "7f3d1c92-8b45-4e6a-9d21-5c8e0a4b6f13",
  "data": {
    "plan_id": "c4e82f16-93a7-4d5b-b81c-6e0f27a94d3b",
    "window_id": "3d5a8c72-b016-4e94-8fa7-61c209d4e738",
    "starts_at": "2026-09-20T13:00:00+00:00",
    "ends_at": "2026-09-21T03:00:00+00:00",
    "subscribers_affected": 47
  }
}

Field reference

Field	Type	Notes
`id`	string ULID	Unique event id, prefixed `evt_`. Use for idempotent processing.
`type`	string	Always `pass.window_closed` for this event.
`created_at`	ISO 8601 timestamp	Server-side emission time.
`api_version`	string	Webhook API contract version.
`project_id`	string UUID	Project this event belongs to.
`data.plan_id`	string UUID	The pass plan the window belongs to.
`data.window_id`	string UUID	The access window that closed.
`data.starts_at`	ISO 8601 timestamp	Window start, always UTC.
`data.ends_at`	ISO 8601 timestamp	Window end, always UTC.
`data.subscribers_affected`	integer	How many holders were settled and had this window's access removed. A holder only has their pass ended when this was the last date they held; mid-series holders are included in this count but keep their subscription.

Caveats

Timestamps are UTC — convert to the plan's schedule timezone before showing them.
A subscription that this close ends also emits subscription.expired, and member.churned when it was the subscriber's last active subscription. A series holder mid-slate emits neither — only pass_series.leg_completed. De-duplicate if you consume several of these.
A cancelled window does not emit this event. It emits pass.window_cancelled instead, with per-holder detail in pass.holder_moved and pass.holder_stranded.

pass.window_opened — paired transition.
member.resource_removed — per-subscriber revocation.
Pass events overview — back to family overview.