Submit activity report from device

POST/device/report

Submit screen time, app usage, or other activity data. Stored in device_reports and fanned out to activity_logs. Use report_type: enforcement_status with an EnforcementStatusPayload to report per-category enforcement results; this also updates the device's enforcement_summary for the parent dashboard.

Auth:X-Device-Key

Request body

report_type

One of: screen_time, app_usage, web_activity, blocked_attempt, enforcement_status.

screen_time | app_usage | web_activity | blocked_attempt | enforcement_statusrequired

payload

Report data (varies by report_type). For enforcement_status see EnforcementStatusPayload.

objectrequired

reported_at

RFC 3339 timestamp.

datetimerequired

Request

bash

curl -sS -X POST "https://phosra-api-sandbox-production.up.railway.app/api/v1/device/report" \
  -H "X-Device-Key: $PHOSRA_DEVICE_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "report_type": "screen_time",
  "payload": {
    "minutes_used": 74,
    "top_app": "com.example.game"
  },
  "reported_at": "2026-07-06T14:30:00Z"
}'