Screentime.QuietHoursReached

Emitted when a quiet-hours window begins. The paired earlier signal is Screentime.QuietHoursWarning, which fires 15 minutes ahead so the player is told before the window lands rather than at it.

Subscribe your endpoint to this event

k-ID delivers Screentime.QuietHoursReached only to endpoints subscribed to it, and drops it for the rest without a delivery attempt or an error. Select it for your endpoint on the product's Developer Settings page. See Before you start.

endsAt is the useful field: it's when the window closes, so you can tell the player when they can come back rather than only that they can't play now. The window is evaluated in the schedule's time zone and endsAt correctly rolls to the next day for a window that crosses midnight, such as 21:00 to 07:00.

k-ID doesn't sign the player out or block anything. Confirm the verdict with GET /screentime/get-state: during an active window access.allowed is false, access.details.reason is quiet_hours, and access.details.resumesAt matches this event's endsAt.

A player can ask a parent to lift the window with /screentime/request-override. The answer arrives as Screentime.OverrideResult.

Fields

Field	Type	Required	Description
eventType	string	yes	Always "Screentime.QuietHoursReached"
data	object	yes	Quiet hours data
data.sessionId	string (UUID)	yes	Session ID the window applies to
data.productId	number	yes	Product ID
data.windowName	string	yes	The parent's name for the window, for example "Bedtime"
data.endsAt	string (RFC 3339)	yes	When the window closes and play can resume

Example

{
  "eventType": "Screentime.QuietHoursReached",
  "data": {
    "sessionId": "b1a6482d-5242-4b4a-aa88-3fa52595a672",
    "productId": 42,
    "windowName": "Bedtime",
    "endsAt": "2026-06-25T07:00:00+09:00"
  }
}

Fires whether or not a session is in flight

As with the warning, this event is driven by the parent's calendar rather than by /screentime/start. It fires for any player with a live k-ID session on your product, even when no screentime session is in progress.