Back to Home
Developer Platform & Endpoints

HTTP Endpoints, Webhooks & Schedulers

EstateTrack uses Next.js Server Actions for standard portal mutations. The HTTP endpoints below are reserved for automated webhooks, Vercel cron schedulers, and statutory PDF generation.

Authentication & Security Model

Cron endpoints require a cryptographically verified secret header: Authorization: Bearer CRON_SECRET. Webhook endpoints verify digital provider signatures before writing to the append-only ledger.

Active Endpoints & Schedulers

POST/api/webhooks/billing/settlement
HMAC / Gateway Signature

Two-witness settlement webhook receiving direct gateway confirmations and committing to the immutable settlement ledger.

GET/api/cron/generate-invoices
Bearer CRON_SECRET

Executes on the 28th of every month. Generates recurring rent invoices, applies metered utilities, and nets off advance credits.

GET/api/cron/rent
Bearer CRON_SECRET

Daily invoice reminders (T-3 days, T-0 due date, grace-period expiration) with contextual deep links.

GET/api/cron/billing
Bearer CRON_SECRET

Checks platform SaaS subscription standings, grace periods, and renewal obligations for landlords.

GET/api/cron/optimize
Bearer CRON_SECRET

Nightly maintenance cleanup: prunes settled ticket photos, old notifications, and soft-deleted rows older than 30 days.

POST/api/notifications/send
Bearer / Session

Universal event bus: dispatches multi-channel alerts (in-app ledger, realtime WebSocket, and VAPID Web Push).

POST/api/push/subscribe
Authenticated Session

Registers browser Web Push subscriptions with VAPID authentication for lockscreen notifications.

GET/api/reports/tax?year=YYYY
Landlord Session

Generates formal publication-grade statutory tax PDF reports with IRS Schedule E lines and MACRS depreciation.