Skip to content

API reference (endpoints)

The API exposes 44 endpoints across 12 groups, all under the /api base path. This list is generated from the Express route files (complete + drift-proof). Request/response schemas for the stable public subset are in lib/api-spec/openapi.yaml; expanding that spec to full coverage is tracked in the authoring backlog.

/

MethodPath
GET/api/healthz
GET/api/readyz

/alerts

MethodPath
GET/api/alerts/active

/assets

MethodPath
GET/api/assets
POST/api/assets
DELETE/api/assets/:id
PATCH/api/assets/:id
POST/api/assets/:id/regenerate-route
GET/api/assets/:id/risk

/auth

MethodPath
POST/api/auth/email
POST/api/auth/email/request-password-reset
POST/api/auth/email/request-verification
POST/api/auth/email/reset-password
POST/api/auth/email/verify
POST/api/auth/google
POST/api/auth/login
POST/api/auth/logout
POST/api/auth/microsoft
POST/api/auth/phone/request-otp
POST/api/auth/phone/verify-otp
POST/api/auth/register

/checkin

MethodPath
POST/api/checkin/:sessionId/status
POST/api/checkin/start

/fires

MethodPath
GET/api/fires/:id/spread
GET/api/fires/nearby
GET/api/fires/threats

/forecast

MethodPath
GET/api/forecast/next-6h
GET/api/forecast/wind-arrows

/geocode

MethodPath
GET/api/geocode/reverse
GET/api/geocode/search

/notifications

MethodPath
POST/api/notifications/:id/ack
DELETE/api/notifications/device-token
POST/api/notifications/device-token
GET/api/notifications/inbox
GET/api/notifications/preferences
PUT/api/notifications/preferences
POST/api/notifications/test

/places

MethodPath
GET/api/places/nearby

/predictions

MethodPath
GET/api/predictions/:predictionId/etas
GET/api/predictions/:predictionId/stream
GET/api/predictions/files/:jobId/:filename
GET/api/predictions/wind
GET/api/predictions/wind-for-hotspot

/routes

MethodPath
GET/api/routes/:assetId